sessiongrep

You solved that bug last week. Your next agent session has no idea.

A local-first memory layer for CLI agents. sessiongrep indexes your Claude Code, Codex CLI, Cursor, Antigravity, and Pi session histories into a single SQLite + FTS5 database, then gives you one CLI/TUI to find old work by topic, repo, provider, or recency. It also ships an MCP server so your agent can search its own history.

The real payoff is portable context: your session history isn't trapped in one tool. Work you started in Claude Code can continue in Codex, and an agent can recover — and even critique — its own prior reasoning across every tool you use.

Read the announcement: Sessiongrep: a local-first memory layer for CLI agents.

Why

Session transcripts already live on your machine — scattered across ~/.claude/projects, ~/.codex/sessions, ~/.cursor/projects as noisy JSONL with opaque filenames. The information is not missing, it's stranded. Humans don't want to read it; agents don't know how to retrieve it. Grep over JSONL drowns in tool payloads. Shell history captures commands but not reasoning. Cloud-synced or vector-backed alternatives bring secrets and URLs into systems that aren't yours.

sessiongrep keeps recall local. One static binary, one SQLite file, no daemon, no server. The index is a disposable cache — delete it and rebuild it whenever you want.

How it works

Provider adapters normalize Claude, Codex, Cursor, Antigravity, and Pi transcripts into a single Session model and write them into SQLite (WAL mode) with an FTS5 virtual table over transcript text, title, summary, and preview. Every read command runs an incremental reindex first — files whose mtime and size haven't changed are skipped, so search and list stay fast even as your history grows.

Only the conversation is indexed: your prompts and the agent's replies. Tool calls and their output, injected context (AGENTS.md, skill bodies, system reminders), and sub-agent transcripts are left out, so a hit points at what was discussed rather than at every file an agent happened to read. Titles come from each tool's own session names where they exist (Claude Code's /rename and generated titles, Codex thread names), falling back to the first prompt.

Installation

You need session history from at least one of Claude Code, Codex CLI, Cursor, Antigravity, or Pi.

Prebuilt binaries (macOS, Linux)

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/braincompany/sessiongrep/releases/latest/download/sessiongrep-installer.sh | sh

The installer picks the build for your platform, verifies its checksum, and adds ~/.cargo/bin to your PATH if needed. Archives for manual download are on the releases page.

With Cargo

Requires a Rust toolchain 1.88 or newer:

cargo install sessiongrep --locked

To build the latest main instead: cargo install --locked --git https://github.com/braincompany/sessiongrep. Nix users can install from the flake: nix profile install github:braincompany/sessiongrep.

Every method installs two binaries into ~/.cargo/bin/:

• sessiongrep — CLI and TUI
• sessiongrep-mcp — MCP server

To upgrade, run the same command again.

Index your sessions