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.
/plugin marketplace add v-amorim/moonlight-claude-mods /plugin install mod-progress@claude-mods
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

What it hooks into
ui.toastA Claude Code eventsession.startWhen a session startssession.endWhen a session endscommand.runWhen you run its slash command/mod-progressui.closeWhen its pane closesstate.setA Claude Code eventagent.spawnWhen a subagent startssession.sendA Claude Code eventturn.startWhen Claude starts a turnturn.stepAt each step of a turnturn.completeWhen a turn endstool.callAround a tool call, where it can hold oneprompt.submitWhen you send a promptui.renderDraws into the sessionUserMessageAbovePromptPaneui.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 0Stopexec 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 0SubagentStopexec 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 0StopFailureexec 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 0SessionEndexec 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
- Folder
- mod-progress
- Version
- 2.0.1
- License
- MIT
- Repo stars
- 5
- Last change
- 2026-10-30
- Language
- TypeScript
- Files
- 25