Recording every session

What did you build last Tuesday?

ccvault archives every Claude Code conversation into a searchable vault. Full-text search, interactive TUI, DuckDB analytics, and MCP integration.

Get Started View on GitHub

ccvault

$ ccvault search "debugging the auth flow"

Found 3 results:

1. [assistant] 2026-02-12 14:32

Project: myapp

...found the root cause in the auth middleware...

2. [user] 2026-02-10 09:15

Project: backend-api

...the auth flow breaks when the token expires...

3. [assistant] 2026-01-28 16:44

Project: myapp

...let me debug the session handling...

Capabilities

Everything your conversation history needs

From lightning-fast search to deep analytics, ccvault turns your ~/.claude directory into a structured, queryable archive.

Full-Text Search with FTS5

Gmail-like query syntax with operators for projects, models, tools, dates, and exact phrases. Powered by SQLite FTS5 for instant results across thousands of sessions.

$ ccvault search "project:myapp tool:Edit after:2026-01-01"

Interactive TUI

Browse projects, drill into sessions, and read full conversations in a Bubble Tea-powered terminal interface.

DuckDB Analytics

Export to Parquet and query with DuckDB for aggregate analytics: token usage, model breakdown, project trends.

MCP Server

8 tools and 6 prompts over JSON-RPC. Give your AI assistants access to your full conversation history.

Markdown Export

Export any session to clean, readable markdown with tool usage details, thinking blocks, and full metadata.

Workflow

Three commands. That's it.

Sync

Index your conversations from ~/.claude into a local SQLite database. Incremental by default, only processes new sessions.

ccvault sync

Search

Query across every conversation with Gmail-like operators. Filter by project, model, tool, date range, or free text.

ccvault search "fixing the bug"

Analyze

Browse with the TUI, export to markdown, build analytics caches, or connect via MCP for AI-powered insights.

ccvault tui

Query Language

Search like you mean it

Gmail-like operators let you slice through thousands of sessions to find exactly what you need.

project:name Filter by project path or name

model:opus Filter by model (partial match)

tool:Bash Sessions using a specific tool

file:path Filter by file path

before: / after: Date range filters (YYYY-MM-DD)

has:error Sessions containing errors

has:subagent Sessions with subagent usage

"exact phrase" Exact phrase matching

Example Queries

ccvault search "debugging the API endpoint" Free-text search across all conversations

ccvault search "project:myapp after:2026-01-01" Project-scoped with date filter

ccvault search "tool:Edit model:opus" Find Edit tool usage in Opus sessions

ccvault search "has:error project:backend" Error sessions in a specific project

ccvault search '"error handling" project:api' Exact phrase with project filter

AI Integration

Give your AI access to your history

The MCP server exposes 8 tools and 6 prompts over JSON-RPC, letting any MCP-compatible assistant search and analyze your conversations.

search_conversations

Full-text search with pagination

get_session_summary

Quick session overview

get_turns

Paginated conversation turns

get_session

Full session as markdown

list_sessions

Recent sessions by project

list_projects

All indexed projects

get_stats

Archive statistics

get_analytics

Usage analytics + DuckDB

Claude Desktop Config

claude_desktop_config.json

{

"mcpServers": {

"ccvault": {

"command": "ccvault",

"args": ["mcp"]

}

Get Started

Install in seconds

Homebrew, go install, or build from source. Pick your path and start archiving.

Homebrew

macOS and Linux

$ brew install 2389-research/tap/ccvault

Go Install

Requires Go 1.25+

$ go install github.com/2389-research/ccvault/cmd/ccvault@latest

From Source

Build it yourself

$ git clone https://github.com/2389-research/ccvault.git
$ cd ccvault
$ make build