ClaudeCodeMod

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.

In your shell
claude plugin marketplace add nateherkai/claude-code-mods
claude plugin install goal-meter@nateherk-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
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

The goal-meter section on the author's GitHub page
Screenshot of the author's GitHub page.

What it hooks into

  • session.startWhen a session starts
  • command.runWhen you run its slash command/goal/goals/goal-meter
  • prompt.submitWhen you send a prompt
  • turn.startWhen Claude starts a turn
  • classic.StopA Claude Code event
  • tool.callAround a tool call, where it can hold one
  • agent.spawnWhen a subagent starts
  • session.appendWhen an entry is written to the transcript
  • turn.completeWhen a turn ends
  • ui.closeWhen its pane closes
  • ui.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
Repo
nateherkai/claude-code-mods
Folder
goal-meter
Version
1.0.0
License
MIT
Repo stars
47
Last change
2026-10-02
Language
JavaScript
Files
6

Other mods in Workflow

ctx-handoffcablateHolds a commandKeeps the cache warm while you are away, turns what you teach Claude into project notes, and can hand a full session to a fresh conversation.mod-storehellosverreOpens /mods, a pane that browses and searches community mods, shows what each one can access, and installs one when you press Install.supermemorysupermemoryaiGives Claude memory across sessions through Supermemory, with a recall strip above the prompt that shows what it found for your prompt.remctlviticciDraws today's Apple Reminders above the prompt in your lists' colors, with a /reminders pane where ✓ completes a task, and gives Claude RemCTL's tools.code-modernizationAnthropicAdds a live pane to Anthropic's code-modernization plugin: the map of your legacy code, how far each part has got, each module's proof verdict, and what to run next.auto-handoffobieWrites a handoff file after the session sits idle, runs that handoff as if you typed it, and toasts when it does.dream-passray-amjadTidies Claude's memory folder, merging duplicates and dropping dead entries, and shows the counts in a band with a pane, a backup, and undo.snippetsSingh-APKeeps saved prompts and drops one into the prompt box with /snip, with the branch, the date, and your last selection filled in.answer-paneVedantAndhaleDraws explain, plan, and ELI5 pages in a side pane, with decision buttons on a plan and Respond filling the prompt box.plan-progresszycckDraws live progress bars above the prompt, one row per task with its stages, steps, and the subagents under it.open-askserikdarlingdataDraws each question the session is waiting on in a band above the prompt, with the recommended answer, until you answer or drop it.conversation-atlasNeelAPatelOpens a side pane that maps the session: the goal, the current path, detours, decisions, open questions, and what to resume next.
All 396 in Workflow