ClaudeCodeMod

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.

In your shell
claude plugin marketplace add vumichien/claude-code-mods-kit
claude plugin install plan-meter@chien-mods
Open the repo

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

The plan-meter row of the mods table in the author's claude-code-mods-kit README: a one-line band above the prompt that says how far your plan is, shown with the author's sample, plan ▸ Ship the export · phases 1/3 · steps 3/6 (50%) · now: API · Claude's tasks 2/5; it reads your plan file, the phase files it links to, and Claude's own task list, and /plan-meter opens a pane with the details.
Screenshot of the author's GitHub page.

What it hooks into

  • session.startWhen a session starts
  • command.runWhen you run its slash command/plan-meter
  • tool.callAround a tool call, where it can hold one
  • ui.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
Repo
vumichien/claude-code-mods-kit
Folder
plugins/plan-meter
Version
0.3.0
License
MIT
Repo stars
4
Last change
2026-10-10
Language
TypeScript
Files
8

Other mods in Workflow

idea-shelfvumichienParks an idea with /idea while Claude works, counts the shelf in a band, and sends nothing to the model until you press Send.session-monitorvumichienDraws a band of your other Claude Code sessions, how many wait on you, work, or are done, with their own line for sessions in this folder.caffeinezienagReminds the agent of each shell it left running in the background, and toasts when a reminder wakes an idle session.where-am-ihamzaferDraws four things above the prompt: the goal, what is happening now, what is waiting on you, and the next step.next-stepshamzaferAfter each turn, draws two or three likely next prompts. In an empty prompt, 1, 2, or 3 drafts one. 0 dismisses them.agent-radarhamzaferDraws one line above the prompt for each running subagent: time, tool count, and what it is doing.mission-controlhamzafer/mission opens a pane of the main agent, its subagents, every tool call, and the files they touch.agent-quick-menuagentic-workbenchPuts installed plugins' commands and settings, and Claude Code's own settings, in a pane beside the session, with a favorites line above the prompt.browser-laneshamzaferHolds a commandDraws whether this session has a Playwright browser and who holds it. A subagent that wants the browser waits until the one using it is done.glancehamzaferDraws one line above the prompt for what needs you: the next meeting, pull requests, Linear issues, and Slack DMs.session-saverhamzafer/park saves where you left off. The next time that session resumes, it draws the note.prayer-timeshamzaferDraws the current prayer and how long is left, the next prayer, and zawal, above the prompt. Computed on your computer. The author says nothing is sent out.
All 396 in Workflow