session-recall

Session Recall Skill

Load and summarize recent Claude Code sessions for the current working directory (including subdirectories). This gives you context about what was discussed, what files were changed, and what commands were run in prior sessions.

Workflow

Step 1: Run the recall script

python3 ${CLAUDE_SKILL_DIR}/scripts/recall_cli.py --cwd "$(pwd)" ```

If the user specifies a different time range (e.g., "last week"), adjust `--days` accordingly:
```bash
python3 ${CLAUDE_SKILL_DIR}/scripts/recall_cli.py --cwd "$(pwd)" --days 7 ```

If the user wants more sessions, adjust `--min-sessions`:
```bash
python3 ${CLAUDE_SKILL_DIR}/scripts/recall_cli.py --cwd "$(pwd)" --min-sessions 5 ```

To adjust the token budget (default 40k):
```bash
python3 ${CLAUDE_SKILL_DIR}/scripts/recall_cli.py --cwd "$(pwd)" --max-tokens 80000 ```

### Step 2: Summarize

Read the output and provide a **concise summary** to the user:

1. **Timeline**: When each session happened and how long it lasted
2. **What was done**: The key tasks, questions asked, and outcomes in each session
3. **Files changed**: Any files that were created or modified
4. **Open threads**: Any unfinished work, unanswered questions, or next steps that were mentioned

Keep the summary brief and actionable. Focus on what's most relevant for continuing work.

## Notes

- The script searches `~/.claude/projects/` for session logs matching the current working directory
- It includes sessions from subdirectories of the current cwd
- Selection logic: max(last 2 days, last 2 sessions) — configurable via `--days` and `--min-sessions`
- The current (most recent) session is excluded by default; use `--include-current` to override
- Subagent logs are merged chronologically into their parent session if main sessions fit under the token budget
- Output is capped at 40k tokens (configurable via `--max-tokens`); oldest messages are trimmed first, then entire sessions are dropped if needed
- Uses tiktoken for approximate token counting (requires `pip3 install tiktoken`)
- Progress/debug output goes to stderr; structured output goes to stdout