---
title: "ccvault"
description: "Archive and search your Claude Code conversations. Full-text search, analytics, and MCP integration for everything in ~/.claude."
canonical_url: "https://2389.ai/products/ccvault/"
last_updated: "2026-03-17T11:10:28-05:00"
doc_version: "1.0"
date: 2026-02-14
product_type: "Tool"
status: "Beta"
tags: ["claude-code", "search", "analytics", "mcp", "cli", "developer-tools", "open-source"]
---

# ccvault

> Archive and search your Claude Code conversations. Full-text search, analytics, and MCP integration for everything in ~/.claude.


ccvault syncs your Claude Code sessions from `~/.claude` into a local SQLite database with FTS5 full-text search. You get Gmail-style query syntax, a terminal UI for browsing sessions, Parquet exports for analytics, and an MCP server so other AI tools can search your history too.

## Install

```bash
brew install 2389-research/tap/ccvault
```

Or with Go 1.25+:

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

## What it does

**Search** — Query your conversations with filters like `project:myapp`, `model:opus`, `tool:Bash`, `after:2025-01-01`, `has:error`, or plain text. Exact phrase matching works too.

**Browse** — A Bubble Tea TUI lets you scroll through sessions, view turn-by-turn details, and drill into specific conversations without leaving the terminal.

**Analytics** — Exports session data to Parquet files. Run DuckDB queries against your usage patterns: which models you use most, which tools get called, how sessions break down by project.

**MCP server** — Eight tools (search, session summaries, paginated turns, stats, analytics) exposed over Model Context Protocol. Point Claude Desktop or any MCP client at `ccvault mcp` and your conversation archive becomes searchable by other agents.

**Incremental sync** — Tracks file modification times so re-syncing is fast. Only new or changed sessions get processed.

## How it works

Claude Code stores sessions as JSONL files under `~/.claude/projects/`. ccvault parses these files, extracts turns (with role, model, tool usage, timestamps), and writes them to SQLite with FTS5 triggers for instant full-text indexing. A separate `build-cache` command exports the same data to Parquet for DuckDB analytics.

## Requirements

Go 1.25+ for building from source. Homebrew handles dependencies automatically.


## Sitemap

Parent: [Products](https://2389.ai/products/index.md)

Related pages in this section:

- [Skills Marketplace](https://2389.ai/products/skills-marketplace/index.md)
- [Mammoth](https://2389.ai/products/mammoth/index.md)
- [BotBoard](https://2389.ai/products/botboard/index.md)
- [Smasher](https://2389.ai/products/smasher/index.md)
- [Jeff](https://2389.ai/products/jeff/index.md)
- [Mux](https://2389.ai/products/mux/index.md)
- [ISH](https://2389.ai/products/ish/index.md)
- [Coven](https://2389.ai/products/coven/index.md)
- [Soloclaw](https://2389.ai/products/soloclaw/index.md)
- [GSuite MCP](https://2389.ai/products/gsuite-mcp/index.md)


Site index: [llms.txt](https://2389.ai/llms.txt) · [sitemap.md](https://2389.ai/sitemap.md) · [HTML](https://2389.ai/products/ccvault/)