status · trailofbits — Claude Code command: what it does, how to install
status reads task_plan.md to display phase milestones and summarizes notes from findings.md.
CC-BY-SA-4.0 ★ 540 updated 2026-07-14
/plugin marketplace add trailofbits/skills-curated
/plugin install planning-with-files@skills-curatedWhat status does
The command inspects task_plan.md in the workspace root to generate a concise progress breakdown. It pulls the overall goal statement, lists every milestone, and marks items as [done], [current], [pending], or [blocked]. It also calculates the total completed phase count.
When findings.md is present, it counts logged research points, technical decisions, and issues. Without task_plan.md in the root folder, the command halts and tells you to generate a plan first.
What it helps with
- check task completion stages across the project
- identify blocked steps in the current plan
- count recorded decisions and issues in findings.md
Example prompts for the agent
- Run
/planning-with-files:statusto inspect current progress - Show the phase summary from
task_plan.md
How to install status
1Plugin marketplace
/plugin marketplace add trailofbits/skills-curated/plugin install planning-with-files@skills-curated2Manually: put the files in place
.claude/commands/planning-with-files-status.mdThe built-in /status overrides a file with the same name, so the file is renamed. Call it with /planning-with-files-status. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/status.mdCall it with /prompts:status. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/status.prompt.mdManually: put the files in place
.gemini/commands/status.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about status
How do I install status in Claude Code?
Add the repository with /plugin marketplace add trailofbits/skills-curated, then install the bundle via /plugin install planning-with-files@skills-curated.
What does the status command do?
It inspects task_plan.md to print an ASCII phase progress overview and tallies entries in findings.md.
What happens if task_plan.md is missing?
The command stops immediately and reminds you to create the file first with the planning prompt.
Similar slash commands
All slash commands for Notes, tasks and projects →status by other authors comes first.