status

status is a command for Claude Code from Hassaan146/forge-mentor. It costs 9 tokens per session (862 once invoked), scanned A, original, MIT.

A command that reports the project's recorded progress, answered questions, decisions, finished phases, and next step. It rebuilds this summary from the project's saved records.

In plain words
What is it for?
Use it when reopening a project, checking its current stage, or continuing planned development work.
Why use it?
It helps someone resume work after a gap without relying on memory or an outdated progress note. It also identifies when the next action should happen automatically.

Command for Claude Code

Written for Claude Code: ${CLAUDE_PLUGIN_ROOT} variable. Also seen: mentions subagents.

Runs only inside its plugin — its command needs a path that Claude Code sets for a plugin’s own hooks and for nothing else. Install the plugin, not this.

Part of the forge plugin — 4 skills, 6 commands, 4 agents, 4 hooks, 1 MCP server shipped together

Good fit Use it when reopening a project, checking its current stage, or continuing planned development work.

Compare 6 commands from other repositories ↓
Install

Getting it into your agent

This one installs as part of its plugin. Adding the marketplace and installing the plugin brings it with everything else the plugin ships.

Claude Code
/plugin marketplace add Hassaan146/forge-mentor
Claude Code
/plugin install forge

Made for: Claude Code.

Or install forge, the plugin that ships this one along with the rest of its 4 skills, 6 commands, 4 agents, 4 hooks, 1 MCP server.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for status

README.md
[![agentmods](https://agentmods.dev/badge/commands/hassaan146/forge-mentor/status/github.svg)](https://agentmods.dev/commands/hassaan146/forge-mentor/status)
Your own site
<a href="https://agentmods.dev/commands/hassaan146/forge-mentor/status"><img src="https://agentmods.dev/badge/commands/hassaan146/forge-mentor/status/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for status

Your own site · 80×15
<a href="https://agentmods.dev/commands/hassaan146/forge-mentor/status"><img src="https://agentmods.dev/badge/commands/hassaan146/forge-mentor/status.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 9 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 862 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00009 $0.00862
Opus 5 $0.00005 $0.00431
Sonnet 5 $0.00002 $0.00172
Haiku 4.5 $0.00001 $0.00086

Measured 9d ago against content hash 0a022710762a, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, from the pricing page.

Security

Grade A, and why

status scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 9d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

commands/status.md · 69 lines

What it actually says

Show where the work is, and carry on from it.

Start with catch_up. It returns two blocks: the story so far, and whatever comes next. Paste them in that order and stop. That is the whole reply on the common path, which is somebody reopening after a gap and needing to know where they were.

Unless there is no second block. An empty next_block does not mean there is nothing to do, it means nothing is waiting on the user — the step is decided and the next move is Forge's. Do not stop there. Carry straight on in the same turn: current_step, then plan_files, then build it. This ended a real session on the line "No question is open; nothing is blocking you", which reads as a finished report and is actually a loop that forgot to take its turn. Follow the next field that catch_up returns; it says which of the two endings applies.

The summary is assembled from the records every time rather than kept in a log, so there is no second version of the history to drift from the first (decision 011: the repository is the memory). It carries the idea in the user's own words, how many questions are answered against the estimate, how many decisions are recorded, phases finished, steps built, which step is open now, and the last three decisions with what was chosen.

If it reports needs_repair, call check_history, show what is damaged, and offer repair_history, which is the tool that fixes it: it quarantines the damaged records before it writes anything, so nothing is destroyed and the original is still on disk afterwards. Say that, then ask, then run it if they say yes. Telling somebody their notes are broken and naming no repair is the shape of an error message, not of a product. Nothing else on this screen is worth reading until the notes are sound.

If the user asks whether they ever asked for something — "did I say I wanted dark mode", "what did I ask about the database" — call what_did_i_ask_for with their words. It searches the records and returns what they asked, when, and what was decided. Answering from memory here is guessing about the one thing this product exists to have written down.

Everything below is the longer report, for when the user asks for more than a glance.

Steps:

  1. Call next_step for the stage, the subagent, the model, and whether the next step needs the user.
  2. Call current_state for what is decided and what is open.
  3. Call usage_report for tokens used so far. If it reports available: false, say usage is unavailable in one line and carry on — nothing else depends on it.
  4. Call check_history to confirm the decision records are intact.

Then check the version — a status report from a plugin that is two weeks behind describes a project state that may already have moved:

python "${CLAUDE_PLUGIN_ROOT}/scripts/forge_update.py"

It prints nothing when the copy is current. Print what it returns, add nothing.

Then print, using the Forge visual identity:

  • the banner, then the progress bar with the count of questions answered against the estimate (rule R4 — always show how many remain)
  • the current stage in plain words, and what happens next
  • the open question, if there is one, and that code is blocked until it is answered — put the question itself through render_action, because it is the one thing on this screen the user can do something about, and everything around it is a report
  • which model does the next step and why (rule R2 — name it: "Fable 5", not "the teaching model")
  • usage, and any threshold warning
  • anything the review still has open

Keep it short. This is a glance, not a report.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 9d ago First seen · 69 lines · 9 tokens per session scan A 0a022710762a

Subscribe to this mod's changes

status is a command published in the GitHub repository Hassaan146/forge-mentor (22 stars, last pushed 23d ago), licensed MIT. It adds 9 tokens to every session and 862 once invoked, about $0.0000 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.