Gordon Beeming

Father • Husband • Triathlete • SSW Solution Architect

← back to projects
Project

Claude Recall

2

Search and explore your Claude Code session history from the terminal. Uses Claude itself to generate search terms and validate matches; pass `--no-ai` for a pure-text mode.

C#.NETTUI

README mirrored from GordonBeeming/claude-recall · updated 2026-07-11

claude-recall

Search and explore your Claude Code session history from the terminal.

CI Release

#Prerequisites

  • Claude Code CLI -- claude-recall calls Claude by default to generate search terms and validate matches. Pass --no-ai if you don't have Claude installed or want to skip the AI features.

#Install

#Homebrew (macOS / Linux)

bash
brew tap GordonBeeming/tap
brew install claude-recall

#Manual download

Grab a binary from the latest release and put it on your PATH.

#Build from source

bash
./dev-build.sh

This publishes a native AOT binary for your platform and installs it to ~/.local/bin/claude-recall.

#Usage

bash
claude-recall <query> [options]

If no query is provided, you'll be prompted for one interactively.

#Options

FlagDescription
--regexRaw regex search, skips AI term generation
--no-aiSkip all AI features (works without Claude installed)
--all-projectsSearch all projects (default: current project only)
--days NSearch last N days (default: 7)
--verboseShow detailed progress and debug info
--help, -hShow help
--versionShow version

#Examples

bash
# 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

#How it works

  1. Scan -- reads session files from ~/.claude/projects/
  2. Filter -- scopes to the current project based on your working directory (pass --all-projects to widen)
  3. AI search terms -- sends your query to Claude, which returns multiple regex patterns covering synonyms and variations
  4. Search -- matches those patterns across session messages
  5. AI validation -- Claude ranks results by relevance with a confidence score and short explanation
  6. 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.