spec-kitty-status
Status Board
Show the current status of all work packages in the active feature. This displays:
- Kanban board with WPs organized by lane
- Progress bar showing completion percentage
- Parallelization opportunities (which WPs can run concurrently)
- Next steps recommendations
When to Use
- Before starting work (see what's ready to implement)
- During implementation (track overall progress)
- After completing a WP (see what's next)
- When planning parallelization (identify independent WPs)
Implementation
Run the CLI command to display the status board:
spec-kitty agent tasks status
To specify a feature explicitly:
spec-kitty agent tasks status --feature 012-documentation-mission
The command displays a rich kanban board with:
- Progress bar showing completion percentage
- Work packages organized by lane (planned/doing/for_review/done)
- Summary metrics
Alternative: Python API
For programmatic access (e.g., in Jupyter notebooks or scripts), use the Python function:
from specify_cli.agent_utils.status import show_kanban_status
# Auto-detect feature from current directory/branch
result = show_kanban_status()
# Or specify feature explicitly:
# result = show_kanban_status("012-documentation-mission")
Returns structured data:
{
'feature_slug': '012-documentation-mission',
'progress_percentage': 80.0,
'done_count': 8,
'total_wps': 10,
'by_lane': {
'planned': ['WP09'],
'doing': ['WP10'],
'for_review': [],
'done': ['WP01', 'WP02', ...]
},
'parallelization': {
'ready_wps': [...],
'can_parallelize': True/False,
'parallel_groups': [...]
}
}
## Output Example
╭─────────────────────────────────────────────────────────────────────╮ │ 012-documentation-mission │ │ Progress: 80% [████████░░] │ ╰─────────────────────────────────────────────────────────────────────╯
┌─────────────┬─────────────┬─────────────┬─────────────┐ │ PLANNED │ DOING │ FOR_REVIEW │ DONE │ ├─────────────┼─────────────┼─────────────┼─────────────┤ │ WP09 │ WP10 │ │ WP01 │ │ │ │ │ WP02 │ │ │ │ │ WP03 │ │ │ │ │ ... │ └─────────────┴─────────────┴─────────────┴─────────────┘
🔀 Parallelization: WP09 can start (no dependencies)