All shelves / Mods / Workflow
plan-meter
By vumichien
plan-meter is a Claude Code workflow mod by vumichien.
Draws a one-line band above the prompt with how far your plan file is, in phases and steps, and how many of Claude's own tasks are done.
Draws
Install
The marketplace name is chien-mods.
claude plugin marketplace add vumichien/claude-code-mods-kit claude plugin install plan-meter@chien-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
- 0.3.0
- License
- MIT
- Repo stars
- 4
- Last change
- 2026-10-10
What it can reach
- Draws in the session
Start a new session after installing, then turn it on with /plan-meter on; it starts off. Tested on Claude Code 2.1.296 on Windows 11; mods are an early-access feature, so the API can change between versions. It looks for a plan file named plans/*/plan.md, PLAN.md, plan.md, TODO.md, TASKS.md, ROADMAP.md, todo.txt, or TODO.org, and /plan-meter docs/roadmap.md picks another. The band shows only when there is a plan or a task list. The pane draws in the terminal and the desktop app; under claude -p, /plan-meter answers with the band's line. To try it for one session without installing, git clone the repository and start claude with --plugin-dir pointing at the mod's folder.
The marketplace, chien-mods, also holds secret-guard, done-gate, context-meter, idea-shelf, session-monitor, prompt-enhancer, and assumption-check, each installed on its own. Showing how far a plan has come is why this page files it under workflow. glanceflow, by Antreas-Strb, draws a checklist above the prompt with the plan, the step Claude is on, how far along it is, and when Claude needs you. deadhd draws a session's done, current, and remaining steps as a checklist, in the terminal and on a page. This one reads a plan file you already keep, and Claude's own task list, rather than a list of its own. It understands checklists, status tables, phase headings, linked phase files, org-mode, and todo.txt, with status words in English, Vietnamese, and Japanese, and it updates when a file changes. A plan that gives its progress only in prose has nothing to count, so the band shows its status line if it has one.
Demo

What it hooks into
session.startWhen a session startscommand.runWhen you run its slash command/plan-metertool.callAround a tool call, where it can hold oneui.renderDraws into the sessionAbovePromptPane
Read from the on() calls in its hook modules. Open its source under Files to check what each one does.
Slash commands 1
/plan-meterShow the plan's progress (/plan-meter on or off switches the mod; /plan-meter <path> picks a file)
Files
The author's source, 3 files. They load when you open them.
Facts
- Author
- vumichien
- Category
- Workflow
- Marketplace
- chien-mods
- Folder
- plugins/plan-meter
- Version
- 0.3.0
- License
- MIT
- Repo stars
- 4
- Last change
- 2026-10-10
- Language
- TypeScript
- Files
- 8