Ccrecall

ccrecall

Sync Claude Code transcripts to SQLite for analytics. Query your
session history, token usage, tool calls, and team/swarm data.

Quick Start

Use ccrecall inline in Claude Code sessions. Tell Claude:

Claude runs the command, gets structured output, and can answer
follow-up questions about your session history.

How It Works

Claude Code stores transcripts as JSONL files in
~/.claude/projects/. ccrecall parses these into a SQLite database so
you can query across all sessions.

Step 1. Tell Claude to sync your transcripts:

Step 2. ccrecall incrementally imports new content and reports
what it found:

Step 3. Claude can now query the database using any ccrecall
command or raw SQL:
Important: Claude doesn't know about ccrecall unless you mention
it. Just mention {npx,pnpx,bunx} ccrecall and Claude will discover
subcommands and flags from the CLI output.

Commands

All commands support -v, --verbose for detailed output and
-d, --db  to use a custom database path (default:
~/.claude/ccrecall.db).

Database Schema

Team/Swarm Support

Syncs team data from ~/.claude/teams/ when Claude Code's swarm mode
is enabled.

Why track teams?

- Debug runaway agents: compare prompt (original instructions) vs
  actual behavior
- Link swarm runs to sessions and PRs
- Track task assignments and completion

Example Queries

Requirements

- Node.js 22+

License

MIT