Documentation
README
status โ Plan State Reader
Three variants for different contexts. All backed by scripts/dev/active_plan.py.
Variants
status [feature] โ Full state
The full picture: which plan file is active, its goal, progress (X/N tasks complete), and the next unchecked task block.
Script invocation:
# With a feature name (from $ARGUMENTS or conversation context):
uv run python scripts/dev/active_plan.py --feature <slug>
# Without a feature name (uses root PLAN.md):
uv run python scripts/dev/active_plan.py
Return: the complete script output verbatim.
When to call:
- Starting a session: "where did we leave off?"
- After completing a task: "what comes next?"
- Before adding scope: "does this belong to the current plan?"
This is the opening of the README. Read the full README on GitHub.