Skip to content

v1.1.0 - Session History Search

Latest

Choose a tag to compare

@stefan-jansen stefan-jansen released this 14 Dec 01:02
· 5 commits to main since this release

Session History Search

Claude Code already captures complete session history in ~/.claude/projects/. This release adds tools to query that data.

The Problem

Ever asked yourself:

  • "How did we implement X last time?"
  • "What happened about Y in the last 2 days?"
  • "Didn't we already do this?"

The answers are in your session history - but buried in JSONL files across hundreds of sessions.

The Solution

session-db.py - SQLite-indexed search across all your Claude Code sessions.

# Build index (one-time, then incremental)
python3 scripts/session-db.py index

# Search across all projects
python3 scripts/session-db.py search "authentication"

# Filter by project and time
python3 scripts/session-db.py search "backtest" --project ml4t --days 7

# Timeline view
python3 scripts/session-db.py timeline --days 2

# File changes
python3 scripts/session-db.py files "cli_interface" --days 7

Performance

  • Indexes 2000+ sessions (90K+ actions) in ~3 seconds
  • Queries return in <30ms
  • Database: 38MB vs 1.3GB raw JSONL

What Gets Indexed

  • All tool calls (Bash commands, file edits, reads, searches)
  • Timestamps for temporal queries
  • Cross-project search capability

Files Added

  • scripts/session-db.py - Main SQLite-indexed search tool
  • scripts/session-index.py - Simple per-project search (no DB needed)
  • scripts/session-search.sh - Minimal grep-based search
  • scripts/README.md - Documentation
  • plugins/memory/commands/search.md - Claude Code command wrapper

Full Changelog: v1.0.0...v1.1.0