plan-progress

Reviewed at commit aa1c260

Live plan progress bars above the Claude Code prompt: stages, steps, a pixel fill and soft sounds for decision, error and done

Made by
Kirill Serditov
What we checked

Draws progress bars above the prompt for multi-step tasks, with agent strips, a speed figure and soft sounds. It adds a rule and a tool so Claude fills the bars, refuses the fourth file edit once when no bar exists, and sends Claude back once if a bar is left open. Every six hours it checks GitHub for a new version; Update in its settings window installs it.

Review details

Static review of the source at the pinned commit; not run. Delta review of the changes since b77335e; the rest carries over from the review at that commit. The only plugin change is in hooks/register.tsx and concerns how the plan_progress tool input is parsed: a new asSteps() helper lets steps be plain strings, stages accept 'title' as a name, a flat top-level 'steps' list is accepted, STEP_SCHEMA becomes anyOf string or object, a new 'steps' property is added to the tool schema, and the error message distinguishes an unreadable breakdown from a missing bar. No new hooks, calls, files, hosts or programs; the skill file is unchanged. Carried over: hooks prompt.attachment, turn.start, prompt.submit (adds one context line naming open bars; prompt text is not read), prompt.compose (adds a short rules section), tool.call on all calls (counts Edit/Write/MultiEdit/NotebookEdit; the 4th edit per turn without a bar is denied once; Bash/PowerShell never blocked), tool.call for its own tool, AskUserQuestion and ExitPlanMode, classic.Stop (blocks the stop once when a bar is open after a turn that did work), classic.PermissionRequest and PermissionDenied (observe only), config.set, session.start, session.end, agent.spawn, turn.step (measures tokens per second, chunks unchanged), turn.complete, command.run for /progress commands and ui.render. Runtime calls: $.tool.register, $.command.register, $.store, $.ui.*, $.audio.play for three bundled WAV files, $.config.list/$.config.set (its own options only), $.agent.list, $.session.id, $.tool.list. Programs (fixed commands): on Windows powershell -ExecutionPolicy Bypass to play the bundled WAV and reg query of HKCU Control Panel International LocaleName; elsewhere sh cat of the Omarchy theme colors.toml, defaults read -g AppleInterfaceStyle, gsettings get color-scheme and printf of TERM_PROGRAM. Files read: its own plugin.json, the Claude desktop app's config.json (locale only) and ~/.claude/plugins/installed_plugins.json (to find its marketplace). Network: one GET to api.github.com/repos/zycck/claude-mods/releases 15 s after start and then at most every 6 hours, sending no user data; skipped when its switch is off or CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC is set. Only when the user presses Update does it run claude plugin marketplace update and claude plugin update plan-progress, then /reload-plugins; this is disclosed in the skill. No eval, no settings or shell profile edits, no file writes.

What it uses
  • Reads your prompts: no
  • Sees tool calls: yes
  • Blocks or changes tool calls: yes
  • Reads or writes files: yes
  • Runs programs on your machine: yes
  • Calls the model (uses tokens): no
  • Sends data over the network: yes
  • Stores data: yes
  • Shows something on screen: yes
Hooked events
Screenshot of plan-progress
Made this mod? Add a badge to your README

modsforClaude badge for plan-progress

Paste this into your README. The badge says reviewed once the current version has been reviewed, and links readers to this page.

[![Listed on modsforClaude](https://modsforclaude.com/badge/plan-progress.svg)](https://modsforclaude.com/mods/plan-progress/)

← All mods