sprint-status — Claude Code command: session overview
sprint-status is a Claude Code command that summarizes active sessions and branches. Run it to resume work or check parallel sessions.
MIT ★ 2,966 updated 2026-09-29
/plugin marketplace add rohitg00/pro-workflow
/plugin install pro-workflow@pro-workflowWhat sprint-status does
The command checks for Claude Code processes, Git worktrees, and entries in the session directory. It reports the current project, branch, task, and status; when it finds several sessions, it assembles a sprint-wide view. Use it before changing terminal tabs or when you need to pick up where you left off.
Statuses show whether work is ready to commit or merge, has notes, is blocked, or needs more context. Session discovery uses pgrep, git worktree list, and a listing of $TMPDIR/pro-workflow/sessions/. A session that these checks do not find will not appear in the report.
What it helps with
- check which Claude Code sessions are active
- compare branches and tasks across parallel work
- spot a blocked session or one waiting for context
- recover your place after stepping away
Example prompts for the agent
- Run
/sprint-statusand show me where I left off. - Use
/sprint-statusto list active sessions and their branch status. - Before I switch terminal tabs, run
/sprint-status.
How to install sprint-status
1Plugin marketplace
/plugin marketplace add rohitg00/pro-workflow/plugin install pro-workflow@pro-workflow2Manually: put the files in place
.claude/commands/sprint-status.mdCall it with /sprint-status. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/sprint-status.mdCall it with /prompts:sprint-status. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/sprint-status.prompt.mdManually: put the files in place
.gemini/commands/sprint-status.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about sprint-status
How do I install sprint-status in Claude Code?
Run /plugin marketplace add rohitg00/pro-workflow, then /plugin install pro-workflow@pro-workflow. Invoke the command with /sprint-status.
What does sprint-status do?
It checks for active Claude Code sessions and reports the current task status. When it detects multiple sessions, it creates a combined view across branches.
What do the sprint-status labels mean?
COMPLETE means work is ready to commit or merge; COMPLETE_WITH_NOTES marks finished work with observations. BLOCKED means progress depends on input or an external dependency, while NEEDS_INFO means context is missing.
Source text
sprint-status.md · MIT
---
description: Show status across active parallel sessions
---
# /sprint-status - Parallel Session Tracker
Report status across all active Claude Code sessions.
## Process
1. **Detect active sessions:**
```bash
pgrep -af "claude" | grep -v "$$" | head -10
git worktree list 2>/dev/null
ls $TMPDIR/pro-workflow/sessions/ 2>/dev/null | tail -5
```
2. **Report current session:**
```text
SESSION: <project> | branch: <branch> | task: <current task>
STATUS: COMPLETE | COMPLETE_WITH_NOTES | BLOCKED | NEEDS_INFO
```
3. **Compile sprint view** (if multiple sessions detected):
```text
SPRINT STATUS
Session 1: feat/auth STATUS: COMPLETE (ready to merge)
Session 2: feat/upload STATUS: BLOCKED (waiting on S3 creds)
Session 3: fix/login-bug STATUS: COMPLETE_WITH_NOTES (needs perf review)
```
## Status Definitions
| Status | Meaning |
|--------|---------|
| `COMPLETE` | Done, ready to commit or merge |
| `COMPLETE_WITH_NOTES` | Done, but flagging observations |
| `BLOCKED` | Cannot proceed, needs input or external dep |
| `NEEDS_INFO` | Missing context, asking before guessing |
## When to Use
- Before switching between terminal tabs/sessions
- At the end of a work phase
- When asking "where was I?"
- To orient after being away
---
**Trigger:** Use when running parallel sessions, resuming work, or wanting a quick snapshot of progress across branches.
© Rohit Ghumare · MIT · rohitg00/pro-workflow