recap

# recap: re-entry radar for Claude Code sessions One command, full overview of recent sessions across every project on this machine. Built for the post-reboot moment: which projects, what was each session about, and the exact command to jump back in. ## How to run it Personal or project install (the skill directory is on disk next to this file): ```bash python3 ~/.claude/skills/recap/recap.py [flags] ``` Plugin install (Claude Code exports the plugin root): ```bash python3 "$CLAUDE_PLUGIN_ROOT/skills/recap/recap.py" [flags] ``` Nothing to install beyond Python 3 (stdlib only, no third-party packages). | Flag | Meaning | |------|---------| | (none) | last 15 sessions, newest first, instant, no network | | `--since 7d` | only sessions active in the window (`30m`, `24h`, `7d`, `2w`) | | `--project foo` | filter by substring of the absolute project path; separators are interchangeable (`my_app`, `my-app`, `work/my_app`) | | `--grep PATTERN` | only sessions whose conversation matches PATTERN (regex, case-insensitive); the matching excerpt replaces the `↳` line | | `--dirty` | annotate each row with its project's uncommitted and unpushed counts (read-only git calls) | | `--limit N` | max rows (default 15) | | `--json` | machine-readable output with full session ids and resume commands | | `--no-tail` | hide the `↳` line that says where each session stopped | | `--smart` | real one-sentence summaries via ONE `claude -p` haiku call (network, ~10s) | | `--pick` | choose a row ...