claude-session-recall

claude-session-recall

A Claude Code plugin that loads and summarizes recent session history for the current working directory, bringing previous conversation context into your current session.

What it does

• Discovers session logs matching your current working directory (including subdirectories)
• Parses JSONL session files to extract conversations, files modified, tool usage, and commands run
• Merges subagent logs into parent sessions chronologically
• Selects recent sessions by time window and count threshold
• Trims output to fit a configurable token budget
• Outputs formatted summaries or raw JSON

Install

/plugin install bw2/claude-session-recall

Usage

Invoke with /claude-session-recall:session-recall or just ask Claude "what did we do last time", "recall previous session", or "what was I working on".

You can also run the script directly:

# Default: last 2 days or last 2 sessions, 40k token budget
python3 scripts/recall_cli.py --cwd "$(pwd)"

# Look back further
python3 scripts/recall_cli.py --cwd "$(pwd)" --days 7

# More sessions
python3 scripts/recall_cli.py --cwd "$(pwd)" --min-sessions 5

# Larger token budget
python3 scripts/recall_cli.py --cwd "$(pwd)" --max-tokens 80000

# JSON output
python3 scripts/recall_cli.py --cwd "$(pwd)" --json

# Include current session
python3 scripts/recall_cli.py --cwd "$(pwd)" --include-current

Requirements

• Python 3
• tiktoken (pip3 install tiktoken)