ccvault は ~/.claude にある Claude Code のセッションをローカルの SQLite データベースに同期し、FTS5 全文検索を提供します。Gmail スタイルのクエリ構文、セッションを閲覧するターミナル UI、分析用の Parquet エクスポート、他の AI ツールが履歴を検索できる MCP サーバーが使えます。

インストール

brew install 2389-research/tap/ccvault

または Go 1.25+ で:

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

機能

検索 — project:myapp、model:opus、tool:Bash、after:2025-01-01、has:error、または平文テキストなどのフィルターで会話を検索できます。完全フレーズ一致も機能します。

ブラウズ — Bubble Tea の TUI でセッションをスクロールし、ターンごとの詳細を確認し、ターミナルを離れずに特定の会話を掘り下げられます。

分析 — セッションデータを Parquet ファイルにエクスポートします。使用パターンに対して DuckDB クエリを実行できます: よく使うモデル、呼び出されるツール、プロジェクト別のセッション内訳。

MCP サーバー — 8つのツール（検索、セッションサマリー、ページ付きターン、統計、分析）を Model Context Protocol で公開します。Claude Desktop や任意の MCP クライアントを ccvault mcp に向ければ、会話アーカイブが他のエージェントから検索可能になります。

増分同期 — ファイルの更新時刻を追跡するため、再同期は高速です。新規または変更されたセッションのみ処理されます。

仕組み

Claude Code はセッションを ~/.claude/projects/ 配下に JSONL ファイルとして保存します。ccvault はこれらのファイルをパースしてターン（ロール、モデル、ツール使用状況、タイムスタンプ付き）を抽出し、FTS5 トリガーによる即時全文インデックスとともに SQLite に書き込みます。別の build-cache コマンドが同じデータを DuckDB 分析用の Parquet にエクスポートします。

必要要件

ソースからビルドするには Go 1.25+。Homebrew は依存関係を自動的に処理します。