# status

status reads task_plan.md to display phase milestones and summarizes notes from findings.md.

- command · `type=command` · Claude Code, Codex, GitHub Copilot, Gemini CLI · ★ 540 repo stars
- Author: OthmanAdi
- License: CC-BY-SA-4.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/trailofbits/skills-curated/tree/HEAD/plugins/planning-with-files/commands/status.md
- Updated: 2026-07-14
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/commands/status-2

## What it 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.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add trailofbits/skills-curated
```
In the agent chat (not a shell):
```text
/plugin install planning-with-files@skills-curated
```

2. **Manually: put the files in place**
- File: `.claude/commands/planning-with-files-status.md` — The 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/

### Codex

**Manually: put the files in place**
- File: `~/.codex/prompts/status.md` — Call it with /prompts:status. Codex marks this format deprecated in favour of skills

### GitHub Copilot

**Manually: put the files in place**
- File: `.github/prompts/status.prompt.md`

### Gemini CLI

**Manually: put the files in place**
- File: `.gemini/commands/status.toml` — Gemini stores commands as TOML: the prompt text goes into the prompt field

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/trailofbits/skills-curated/tree/HEAD/plugins/planning-with-files/commands/status.md

## When to use it
- check task completion stages across the project
- identify blocked steps in the current plan
- count recorded decisions and issues in findings.md

## Example prompts
- Run `/planning-with-files:status` to inspect current progress
- Show the phase summary from `task_plan.md`

## Similar
- [team-status](https://affpapa.org/en/nevibecode/commands/sametcelikbicak-team-status.md) — command · ★ 71 repo stars
- [oc-status](https://affpapa.org/en/nevibecode/skills/oc-status.md) — skill · 627 installs
- [ar-status](https://affpapa.org/en/nevibecode/skills/ar-status.md) — skill · 7 installs
- [worktree-status](https://affpapa.org/en/nevibecode/commands/worktree-status.md) — command · ★ 6529 repo stars
- [shadcn-status-checkpoint](https://affpapa.org/en/nevibecode/commands/shadcn-status-checkpoint.md) — command · ★ 267 repo stars
- [sprint-status](https://affpapa.org/en/nevibecode/skills/sprint-status.md) — skill · 634 installs

## Other versions with the same name
- [status · wshobson](https://affpapa.org/en/nevibecode/commands/seth-hobson-status.md) — 348 installs
- [status · openai](https://affpapa.org/en/nevibecode/commands/status.md) — 348 installs
- [status · othmanadi](https://affpapa.org/en/nevibecode/commands/othmanadi-status.md) — ★ 28179 repo stars
- [status · carlrannaberg](https://affpapa.org/en/nevibecode/commands/carlrannaberg-status.md) — ★ 763 repo stars
- [status · hoangsonww](https://affpapa.org/en/nevibecode/commands/son-nguyen-status.md) — ★ 1198 repo stars

From the same set: [trailofbits/skills-curated](https://affpapa.org/en/nevibecode/by/trailofbits/skills-curated.md) — 51 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
