Back to the collection
WorkflowPublic source

Live Plan Progress.

Follow Claude Code plans with live stage and step progress bars, subagent rows and sound cues. Includes plan-progress installation and display controls.

By Kirill SerditovReviewed 2026-10-12
Live Plan Progress preview from the original creator

What it does

Kirill Serditov’s plan-progress mod draws a bar for each task above the Claude Code prompt. The current author README describes stages, steps, elapsed times and subagent rows, with sounds when a task needs input, encounters an error or finishes. Claude reports plan updates through a registered tool; the bars display that reported progress.

  • Per-task stages and steps with elapsed times
  • Subagent rows showing model, effort and current tool
  • Running, needs input, error and done states
  • Session-resume persistence and display controls

How to install plan-progress

This is Kirill Serditov’s plan-progress in zycck/claude-mods, the source associated with the original live-plan demo. Forks and other progress-bar plugins may use different commands.

Read the author’s source before installing, then run these commands inside a Claude Code session:

INSTALL / TERMINAL
/plugin marketplace add zycck/claude-mods
/plugin install plan-progress@zycck-mods

The author README says Claude Code 2.1.286 or newer. The official Mods overview distinguishes terminal 2.1.287+ from Desktop’s bundled 2.1.286+. Check your session’s version with /status; use the official requirements for your surface. The author documents both terminal and Desktop displays; CC Mods has not tested either.

For an already-open session, use /reload-plugins. See the loading and display checklist if the hooks module does not load or no bar appears.

Show, hide and clear the progress bars

  • /progress toggles the bars; the footer’s Progress button does the same.
  • /progress-clear removes all bars.
  • /progress-agents toggles the subagent strips; a bar’s chevron controls that bar.
  • /plan-progress-autoclose toggles automatic removal of finished bars and keeps that choice across sessions.

The README says finished bars remain for 30 seconds by default. Adjust doneBarSeconds in /config. The current plugin metadata identifies version 0.8.2; these controls were source-reviewed on October 12, 2026.

Does 50% mean half the running time is left?

No. Claude creates a plan with the mod’s plan_progress tool and sends step updates. Treat the percentage as reported plan progress, not a runtime forecast or proof that the output has passed checks. The author describes subagent rows as coming from engine events; they are separate from the tool-reported step updates.

What changes when I resume or edit a plan?

The author says bars are saved per session and restored on resume. When a plan changes mid-run, finished steps are retained by title. Running, needs input, error and done are distinct states; sounds accompany questions, errors and completion.

How do the terminal and Desktop displays differ?

The current README describes an SVG bar with a hover layer on Desktop and a character grid in the terminal that animates while Claude is working. This describes the author’s current source, which may differ from the original demo or a fork.

Source: author README and commands. For other workflow ideas, browse workflow mods; to understand the extension type, read mods vs plugins, skills and hooks.

When this mod might be useful

Use plan-progress when a task has several stages or subagents and you want its reported plan to stay visible while Claude works. It helps distinguish waiting for input from ongoing work. A filled bar reflects the plan updates Claude sends, so check the transcript and actual output when deciding whether the task is complete.

Understanding this listing

Use this listing as a starting point for comparing the author’s documented behavior with your own workflow. The repository is the source of truth for installation, configuration, and later changes. The commands here reflect the setup available at the review date.

Before you try it

  • Reviewed the author README and plan-progress 0.8.2 plugin metadata on 2026-10-12. No mod code was executed or security-audited.
  • The author documents terminal and Desktop support. Follow the current official Mods requirements: terminal Claude Code 2.1.287+, or Desktop with bundled Claude Code 2.1.286+.
  • Bars follow reported plan updates; the percentage is not a measured estimate of remaining runtime.

More in workflow