List Plans Command
Display Claude Code plan files stored in ~/.claude/plans/ with extracted metadata.
Quick Reference
list-plans-tool # Show 10 most recent plans
list-plans-tool --all # Show all plans
list-plans-tool --limit 5 # Show 5 most recent
list-plans-tool --filter "deploy" # Filter by title
list-plans-tool --json # JSON output for scripting
list-plans-tool --help # Show help
Output Information
For each plan file, displays:
- Filename: The plan file name (e.g., happy-soaring-rabin.md)
- Title: Extracted from first
# headingin the file - Purpose: First paragraph after the title
- Progress: Count of
[x]completed vs[ ]pending checkboxes - Modified: Last modification timestamp
Use Cases
- Find a plan: Use
--filterto search by title keywords - Review recent work: Default shows 10 most recent by modification time
- Scripting: Use
--jsonfor machine-readable output - Full inventory: Use
--allto see complete plan history