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
0 upvotes
Log in to upvote or save- Made by
- Kirill Serditov
- Pinned commit
-
aa1c260a1fd0f73f7845262ac0937ed21832793a - 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
Made this mod? Add a badge to your README
Paste this into your README. The badge says reviewed once the current version has been reviewed, and links readers to this page.
[](https://modsforclaude.com/mods/plan-progress/)