All shelves / Mods / Workflow
goal-meter
By nateherkai
goal-meter is a Claude Code workflow mod by nateherkai.
Draws a progress bar for /goal from Claude's own task plan: tasks done, elapsed time, an ETA at the goal's pace, and every chat's goal in /goals.
DrawsHolds a command
Install
The marketplace name is nateherk-mods.
claude plugin marketplace add nateherkai/claude-code-mods claude plugin install goal-meter@nateherk-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
- 1.0.0
- License
- MIT
- Repo stars
- 47
- Last change
- 2026-10-02
What it can reach
- Draws in the session
- Holds a command
- Sees tool calls
Claude Code 2.1.287 or later, in the terminal or the desktop app's Code tab, with mods turned on for your account, which the README says Anthropic is doing gradually. Open a new chat after installing: the author says /reload-plugins does not reload it. Type /goal as usual, and Claude first writes its plan with the goal meter's task tool, every task sized S, M, or L, then marks each task started and done as it works. The line above the prompt shows the tasks done out of the plan, a percent and a bar, the time elapsed and about how long is left, how the plan grew, the agents running, and the goal check's last not-met-yet reason; press g for the full list. The footer keeps the percent and the time left when the line is hidden. S, M, and L tasks count 1, 2, and 3, and the ETA uses this goal's own pace and appears once 2 tasks are done. /goals lists this chat's tasks and every other chat's goal from the last 12 hours, /goals hide and show toggle the line, and /goals strict on refuses file edits in a goal before the plan exists. The author says it sends no extra requests to Claude, keeps each chat's goal plan under ~/.claude/mods-data/, and makes no network calls of its own.
The marketplace name is nateherk-mods. The marketplace also holds cache-keeper, recording-mode, and collision-guard. This one installs on its own; to update, run claude plugin marketplace update nateherk-mods, then claude plugin update goal-meter@nateherk-mods, and open a new chat. Watching a /goal move is why this page files it under workflow. plan-progress, by zycck, draws live progress bars above the prompt, one row per task with its stages, steps, and the subagents under it. aim, by Singh-AP, draws one goal above the prompt, with a timer and Done and Clear. This one follows the /goal command, and a plan Claude makes without /goal shows the same way. When Claude finds more work the plan grows, and the bar can step back. Its plugin.json names Nate Herk as its author.
Demo

What it hooks into
session.startWhen a session startscommand.runWhen you run its slash command/goal/goals/goal-meterprompt.submitWhen you send a promptturn.startWhen Claude starts a turnclassic.StopA Claude Code eventtool.callAround a tool call, where it can hold oneagent.spawnWhen a subagent startssession.appendWhen an entry is written to the transcriptturn.completeWhen a turn endsui.closeWhen its pane closesui.renderDraws into the sessionAbovePromptSessionModePane
Read from the on() calls in its hook modules. Open its source under Files to check what each one does.
Slash commands 1
/goal-meter
Files
The author's source, 6 files. They load when you open them.
Facts
- Author
- nateherkai
- Category
- Workflow
- Marketplace
- nateherk-mods
- Folder
- goal-meter
- Version
- 1.0.0
- License
- MIT
- Repo stars
- 47
- Last change
- 2026-10-02
- Language
- JavaScript
- Files
- 6