ClaudeCodeMod

All shelves / Mods / Workflow

mod-progress

By v-amorim

mod-progress is a Claude Code workflow mod by v-amorim.

Draws a Progress panel of the main session and each subagent: model, effort, context, tokens, time and gates, with their background shells and live output.

Draws

Install

The marketplace name is claude-mods.

In Claude Code
/plugin marketplace add v-amorim/moonlight-claude-mods
/plugin install mod-progress@claude-mods
Open the repo

It runs inside the Claude Code process. The side panel is only what the author's README names. Read the repo before you install, or run claude plugin validate on the plugin folder.

Version
2.0.1
License
MIT
Repo stars
5
Last change
2026-10-30

What it can reach

  • Draws in the session
  • Reads usage or context figures

Needs Claude Code 2.1.287 or newer; the author tested on Windows Terminal and macOS iTerm2. /plugin install asks where to install the mod: keep Install for you (user scope), press Enter, press Esc to leave the plugin screen, then run /reload-plugins. Auto-update is off for unofficial marketplaces; turn it on under /plugin, Marketplaces, claude-mods. The README warns that mods are not sandboxed and run with your permissions. Opens from the Progress pill. Gates come from GATES.md files your own script or tool writes, not from the model, and the rest of the mod works without them; the files sit in ~/.claude/gates/<repo>/<session id>/, or under GATES_HOME when you set it. The command hooks need a POSIX shell, Git Bash on Windows; without one they write nothing and the mod falls back to what it can find on its own.

The marketplace, claude-mods, holds 13 mods in the Moonlight look, and other repositories use that name too, so add v-amorim/moonlight-claude-mods. Watching the session and every subagent at once is why this page files it under workflow. agentpane draws a side pane of every subagent, with its current tool, tokens, model, and effort, and its conversation one click away. flightdeck draws a live agent dashboard: the main model's context and cost, every permission check, subagents as cards or swimlanes, and a receipt for each turn. This one covers the main session, every subagent and every agent of a workflow run, and adds the background shells and monitors each one started: a click on a shell opens its full command and live output. A Timeline view shows every agent as a lane on one clock, and a gates view shows a card per loop with one cell per gate: met, waiting on evidence, open or dropped.

Demo

The Features section of the author's README: a background shell's command and live output, a Timeline view with every agent as a lane on one clock, and the gates view, a card per loop with one cell per gate.
Screenshot of the author's GitHub page.

What it hooks into

  • ui.toastA Claude Code event
  • session.startWhen a session starts
  • session.endWhen a session ends
  • command.runWhen you run its slash command/mod-progress
  • ui.closeWhen its pane closes
  • state.setA Claude Code event
  • agent.spawnWhen a subagent starts
  • session.sendA Claude Code event
  • turn.startWhen Claude starts a turn
  • turn.stepAt each step of a turn
  • turn.completeWhen a turn ends
  • tool.callAround a tool call, where it can hold one
  • prompt.submitWhen you send a prompt
  • ui.renderDraws into the sessionUserMessageAbovePromptPane
  • ui.messageAdds a message to the session

Read from the on() calls in its hook modules. Open its source under Files to check what each one does.

Slash commands 1

  • /mod-progress

Hooks 5

  • SessionStartexec 2>/dev/null; IN=$(cat); D="${CLAUDE_CONFIG_DIR:-$HOME/.claude}/mods-data/mod-progress/bridge"; S=$(printf '%s' "$IN" | sed -n 's/.*"session_id":"\([^"]*\)".*/\1/p'); [ -n "$S" ] && mkdir -p "$D" && printf '%s\n' "$IN" >> "$D/$S.jsonl" && find "$D" -name '*.jsonl' -type f -mtime +7 -exec rm -f {} + >/dev/null 2>&1; exit 0
  • Stopexec 2>/dev/null; IN=$(cat); D="${CLAUDE_CONFIG_DIR:-$HOME/.claude}/mods-data/mod-progress/bridge"; S=$(printf '%s' "$IN" | sed -n 's/.*"session_id":"\([^"]*\)".*/\1/p'); [ -n "$S" ] && mkdir -p "$D" && printf '%s\n' "$IN" >> "$D/$S.jsonl"; exit 0
  • SubagentStopexec 2>/dev/null; IN=$(cat); D="${CLAUDE_CONFIG_DIR:-$HOME/.claude}/mods-data/mod-progress/bridge"; S=$(printf '%s' "$IN" | sed -n 's/.*"session_id":"\([^"]*\)".*/\1/p'); [ -n "$S" ] && mkdir -p "$D" && printf '%s\n' "$IN" >> "$D/$S.jsonl"; exit 0
  • StopFailureexec 2>/dev/null; IN=$(cat); D="${CLAUDE_CONFIG_DIR:-$HOME/.claude}/mods-data/mod-progress/bridge"; S=$(printf '%s' "$IN" | sed -n 's/.*"session_id":"\([^"]*\)".*/\1/p'); [ -n "$S" ] && mkdir -p "$D" && printf '%s\n' "$IN" >> "$D/$S.jsonl"; exit 0
  • SessionEndexec 2>/dev/null; IN=$(cat); D="${CLAUDE_CONFIG_DIR:-$HOME/.claude}/mods-data/mod-progress/bridge"; S=$(printf '%s' "$IN" | sed -n 's/.*"session_id":"\([^"]*\)".*/\1/p'); [ -n "$S" ] && rm -f "$D/$S.jsonl" >/dev/null 2>&1; exit 0

Files

The author's README and source, 4 files. They load when you open them.

Facts

Author
v-amorim
Category
Workflow
Marketplace
claude-mods
Repo
v-amorim/moonlight-claude-mods
Folder
mod-progress
Version
2.0.1
License
MIT
Repo stars
5
Last change
2026-10-30
Language
TypeScript
Files
25

Other mods in Workflow

mod-promptsv-amorimDraws a Prompts sidebar of every prompt in the session with its full text; a button jumps the transcript back to it, and a Chain tab lists handed-off sessions.mod-skill-panelv-amorimDraws a Skills panel of your skills and agents, grouped by color tag and model; a click adds one to the prompt, and tags badge skills in the slash list.mod-wrap-upv-amorimDraws a Wrap up pill that hands off to a fresh session or fills /compact with what you keep, and can hand off by itself at 400K tokens or 65% of the window.kairos-forgeVilelaAIHolds a commandDraws a panel of the delivery arc and a band when a human gate waits, asks before a call a revert cannot undo, and masks secrets in tool output.altimate-codeAltimateAIDraws a band for GitHub, Jira and Linear credentials it finds, an /integrations pane, and a /lineage pane of the dbt model Claude reads or edits.xcrewbreferrariHolds a commandDraws a live line above the prompt for each Xcode build and test, gives Claude only the failures, and asks you before Claude rewrites a generated project file.commit-medev-build-deployHolds a commandDenies a git commit whose message is not a Conventional Commit, with commit-me's error text and the allowed types and scopes, so Claude rewrites it.noctia-modsEtienneP-26Draws a Noctia band above the prompt, a side panel of subagents, an agent graph, a task checklist, and toasts when a Noctia guard blocks or questions a command.sidecarkaameo-labDocks a pane beside the chat with Claude's options and questions as buttons, a session summary, a diagram of the files it changed, and a log of each turn.android-device-consoleNathanWAHolds a commandDraws a band of live Android device toggles above the prompt and a /device pane for Doze, standby, and WorkManager jobs, and tells Claude the device state.android-logcatNathanWABounds Claude's adb logcat calls, redacts secrets from adb output, and keeps a pid-scoped logcat buffer for a logcat_grep tool and a /logcat pane.android-project-lensNathanWAHolds a commandAsks before Claude adds a permission that needs a Play Console declaration, gives it the real manifest SDKs and permissions, and adds a nav_graph route index.
All 396 in Workflow