Overview
/gg-status shows where you are in a workflow — which phases or tasks are complete, which are in progress, and what comes next. It works for both project-mode (multi-phase) and task-mode (single-session) workflows. It is read-only and does not modify any files.
Invocation
/gg-status [project-slug]
- No argument — shows the active project, active task, or both if both are running.
- With a project slug — shows the status of the specified project.
What It Produces
A status summary displayed in the chat. No files are written or modified.
my-project — Add user profile endpoints
├── Phase 1: Database schema .............. [execute/done]
├── Phase 2: API endpoints ................ [execute/running]
│ ├── Task 2.1: Create routes ........... done
│ ├── Task 2.2: Add validation .......... todo ← current
│ ├── Task 2.3: Write tests ............. todo
│ └── Task 2.4: Update OpenAPI spec ..... todo
├── Phase 3: Console UI ................... [scaffold/done]
└── Phase 4: Documentation ................ [scaffold/done]
Behavior
Project mode
| Phase state | Suggested action |
|---|
scaffold/done | Run /gg-discuss, /gg-research, or /gg-plan |
plan/done | Run /gg-execute to start implementation |
execute/running | Resume /gg-execute to continue |
execute/done | Run /gg-verify to validate acceptance criteria |
verify/done | Phase complete |
| All phases verified | Project complete — mark the PR as ready for review |
Task mode
| Task state | Suggested action |
|---|
new/pending | Resume /gg-task to begin discussion |
new/done | Resume /gg-task to begin discussion |
discuss/running | Resume /gg-task to continue discussion |
discuss/done | Resume /gg-task to start research |
research/running | Resume /gg-task to continue research |
research/done | Resume /gg-task to generate the plan |
plan/running | Resume /gg-task to finish planning |
plan/done | Resume /gg-task to begin execution |
execute/running | Resume /gg-task to continue execution |
execute/done | Resume /gg-task to run verification |
verify/done | Task complete — archive with jog gg tm archive |
any/error | Run /gg-task to retry the current step |
Use /gg-status anytime you need to orient yourself mid-workflow — after switching branches,
resuming a session, or when you’re unsure what to do next.
