Search and explore your Claude Code session history from the terminal.
- Claude Code CLI -- claude-recall calls Claude by default to generate search terms and validate matches. Pass
--no-aiif you don't have Claude installed or want to skip the AI features.
brew tap GordonBeeming/tap
brew install claude-recallGrab a binary from the latest release and put it on your PATH.
./dev-build.shThis publishes a native AOT binary for your platform and installs it to ~/.local/bin/claude-recall.
claude-recall <query> [options]If no query is provided, you'll be prompted for one interactively.
| Flag | Description |
|---|---|
--regex |
Raw regex search, skips AI term generation |
--no-ai |
Skip all AI features (works without Claude installed) |
--all-projects |
Search all projects (default: current project only) |
--days N |
Search last N days (default: 7) |
--verbose |
Show detailed progress and debug info |
--help, -h |
Show help |
--version |
Show version |
# Search current project sessions for "auth bug"
claude-recall "auth bug"
# Search across all projects
claude-recall "auth bug" --all-projects
# Exact regex search, no AI
claude-recall "fix.*login" --regex
# Works without Claude installed
claude-recall "database migration" --no-ai- Scan -- reads session files from
~/.claude/projects/ - Filter -- scopes to the current project based on your working directory (pass
--all-projectsto widen) - AI search terms -- sends your query to Claude, which returns multiple regex patterns covering synonyms and variations
- Search -- matches those patterns across session messages
- AI validation -- Claude ranks results by relevance with a confidence score and short explanation
- Interactive TUI -- browse the results tree, drill into sessions, resume them, or copy session IDs
Steps 3 and 5 are skipped with --no-ai or --regex.