<div align="center"> <img src="docs/assets/app-icon.png" alt="CCHV Logo" width="120" />

Claude Code History Viewer

The unified history viewer for AI coding assistants.

Browse, search, and analyze conversations from Claude Code, Gemini CLI, Antigravity, Codex CLI, Cline, Cursor, Aider, OpenCode, ForgeCode, CodeBuddy Code, and Grok CLI — as a desktop app or headless server. 100% offline.

Website · Download · Report Bug

Languages: English | 한국어 | 日本語 | 中文 (简体) | 中文 (繁體)

</div>

---

<p align="center"> <img width="49%" alt="Conversation History" src="https://github.com/user-attachments/assets/9a18304d-3f08-4563-a0e6-dd6e6dfd227e" /> <img width="49%" alt="Analytics Dashboard" src="https://github.com/user-attachments/assets/0f869344-4a7c-4f1f-9de3-701af10fc255" /> </p> <p align="center"> <img width="49%" alt="Token Statistics" src="https://github.com/user-attachments/assets/d30f3709-1afb-4f76-8f06-1033a3cb7f4a" /> <img width="49%" alt="Recent Edits" src="https://github.com/user-attachments/assets/8c9fbff3-55dd-4cfc-a135-ddeb719f3057" /> </p>

Quick Start

Desktop app — download and run:

| Platform | Download | |----------|----------| | macOS (Universal) | .dmg | | Windows (x64) | .exe / .zip (portable) | | Linux (x64) | .AppImage |

Homebrew (macOS):

brew install --cask jhlee0409/tap/claude-code-history-viewer

Headless server — access from any browser:

brew install jhlee0409/tap/cchv-server   # or: curl -fsSL https://raw.githubusercontent.com/jhlee0409/claude-code-history-viewer/main/install-server.sh | sh
cchv-server --serve                       # → http://localhost:3727

See Server Mode for Docker, VPS, and systemd setup.

Choose a mode:

| Mode | Best for | What it does | |------|----------|--------------| | Desktop app | Local browsing | Opens local conversation files in a native app | | Headless server | Browser, VPS, or remote access | Serves local conversation files through the WebUI; keep authentication enabled |

---

Why This Exists

AI coding assistants generate thousands of conversation messages, but none of them provide a way to look back at your history across tools. CCHV solves this.

Thirty-one assistants. One viewer. Switch between Claude Code, GitHub Copilot, Gemini CLI, Antigravity, Codex CLI, Cline (incl. Roo Code), Kilo Code, Cursor, Cursor Agent, Aider, OpenCode, ForgeCode, CodeBuddy Code, Grok CLI, Kimi, Kiro, Amazon Q CLI, Continue.dev, PearAI, Goose, Crush, llm, Open Interpreter, Pi, oh-my-pi, Mistral Vibe, Qwen Code, Zed, OpenHands, Trae, and Z Code sessions seamlessly — compare token usage, search across providers, and analyze your workflow in a single interface.

| Provider | Data Location | What You Get | |----------|--------------|--------------| | Claude Code | ~/.claude/projects/ | Full conversation history, tool use, thinking, costs | | GitHub Copilot | ~/.copilot/session-state/ (CLI & Desktop), VS Code workspaceStorage/.../chatSessions/ | Copilot CLI, Copilot Desktop, and VS Code Copilot Chat history (read-only, WSL-aware) | | Gemini CLI | ~/.gemini/history/ | Conversation history with tool calls | | Antigravity | ~/.gemini/antigravity/ | Conversation state under brain/ plus token monitor data under .token-monitor/rpc-cache/v1/ | | Codex CLI | ~/.codex/sessions/ | Session rollouts with agent responses | | Cline (incl. Roo Code; legacy Kilo Code) | ~/.cline/data/sessions/ (current Cline) and VS Code globalStorage/<ext>/tasks/ (older versions) | Task-based history across the Cline family | | Kilo Code | ~/.local/share/kilo/ (kilo.db) | OpenCode-core store since May 2026; the pre-migration Cline-family store stays under Cline | | Cursor | ~/.cursor/ | Composer and chat conversations | | Cursor Agent | ~/.cursor/projects/.../agent-transcripts/ | Agent transcripts, distinct from the Cursor IDE source | | Aider | Project directories | Chat history and edit logs | | OpenCode | ~/.local/share/opencode/ | Conversation sessions and tool results | | ForgeCode | ~/.forge/.forge.db | Conversation history from SQLite database | | CodeBuddy Code | ~/.codebuddy/projects/ | Conversation history with tool calls (Claude Code fork format) | | Grok CLI | ~/.grok/sessions/ | Grok CLI conversations, tool calls, and model usage | | Kimi | ~/.kimi/ | Session history with kimi -r resume | | Kiro | kiro-cli/data.sqlite3 | SQLite-backed conversation history | | Amazon Q CLI | …/amazon-q/data.sqlite3 | SQLite conversations store (shares format with the Kiro CLI provider) | | Continue.dev | ~/.continue/sessions/*.json | Per-session JSON, grouped by workspace (honors CONTINUE_GLOBAL_DIR) | | PearAI | ~/.pearai/sessions/ | Continue fork — same session format | | Goose | …/goose/sessions/sessions.db | Block's agent — SQLite sessions + messages | | Crush | per-project ./.crush/crush.db | Charm's TUI — SQLite, discovered across common code roots | | llm | …/io.datasette.llm/logs.db | Simon Willison's CLI — SQLite conversations/responses with token counts | | Open Interpreter | ~/.openinterpreter/sessions/ | Codex-format rollouts (reuses the Codex parser; INTERPRETER_HOME override) | | Pi | ~/.pi/agent/sessions/ | Per-cwd JSONL transcripts — messages, thinking, tool calls, token usage | | oh-my-pi | ~/.omp/agent/sessions/ | Pi-format sessions from the omp fork (shared parser) | | Mistral Vibe | ~/.vibe/logs/session/ | OpenAI-style chat transcripts with reasoning and tool calls (VIBE_HOME override) | | Qwen Code | ~/.qwen/projects/.../chats/ | Per-session JSONL transcripts (tool calls, thinking, token usage) | | Zed | …/Zed/threads/threads.db | Agent Panel threads — SQLite + Zstd-compressed JSON | | Z Code | ~/.zcode/cli/db/db.sqlite | Z.ai's GLM coding agent — session/message/part SQLite store (titles, tool calls, thinking, token usage) | | OpenHands | ~/.openhands/sessions/ | Classic event-store conversations | | Trae | …/Trae/User/workspaceStorage/.../state.vscdb | Per-workspace chat (icube store; experimental, reverse-engineered) |

No vendor lock-in. No cloud dependency. Your local conversation files, beautifully rendered.

Antigravity note: the viewer resolves the Antigravity root as ~/.gemini/antigravity and then reads session state from brain/ plus usage/cache artifacts from .token-monitor/rpc-cache/v1/; this matches the current runtime layout and root resolver in src-tauri/src/commands/antigravity.rs.

Table of Contents

• Features
• Installation
• Build from Source
• Server Mode (WebUI)
• Usage
• Accessibility
• Tech Stack
• Data Privacy
• Troubleshooting
• Contributing
• License

Features

Core

| Feature | Description | |---------|-------------| | Multi-Provider Support | Unified viewer for 31 AI coding assistants — Claude Code, GitHub Copilot, Gemini CLI, Codex CLI, Cursor / Cursor Agent, Cline (incl. Roo Code), Kilo Code, Aider, OpenCode, ForgeCode, CodeBuddy Code, Grok CLI, Kimi, Kiro, Antigravity, Amazon Q CLI, Continue.dev, PearAI, Goose, Crush, llm, Open Interpreter, Pi, oh-my-pi, Mistral Vibe, Qwen Code, Zed, OpenHands, Trae, and Z Code — filter by provider, compare across tools | | Conversation Browser | Navigate conversations by project/session with worktree grouping | | Global Search | Search across all conversations from all providers instantly | | Analytics Dashboard | Dual-mode token stats (billing vs conversation), cost breakdown, and provider distribution charts | | Session Board | Multi-session visual analysis with pixel view, attribute brushing, and activity timeline | | Settings Manager | Scope-aware Claude Code settings editor with MCP server management | | Message Navigator | Right-side collapsible TOC for quick conversation navigation | | Real-time Monitoring | Live session file watching for instant updates |

Provider Notes

| Provider | Notes | |---------|-------| | Antigravity | Loaded through the standard provider pipeline. Sessions come from the token monitor cache and participate in project/session views, token stats, analytics, and global search without a separate UI mode. |

New in v1.32.0

| Feature | Description | |---------|-------------| | Jump between prompts | Alt+↑ / Alt+↓ (⌥↑ / ⌥↓ on macOS) moves the message list to the previous or next prompt you typed, with or without the Messages panel open | | Session minimap | Optional strip beside the message list that shows the whole session by row kind; click or drag to move. Settings menu → Show session minimap | | Restore preview fixed | Recent Edits' restore confirmation shows what will change (now in the WebUI too) and refuses symlinked targets |

New in v1.31.0

| Feature | Description | |---------|-------------| | Custom resume arguments | Settings → Session Resume Arguments adds extra flags per CLI, used by Copy Resume Command and when resuming sessions in a terminal, with a live preview; dangerous flags are highlighted | | Correct Claude Opus 5.5 cost | Opus 5.5 sessions are priced at Opus 5.5's own rates (they were billed at Opus 5's); pricing added for GPT-6, Gemini 3.8 Flash and Grok 4.7 |

New in v1.30.0

| Feature | Description | |---------|-------------| | WebUI security hardening | In --serve mode, session and project paths are limited to your history folders, and project settings to known projects — upgrade if you run the WebUI (advisory) | | Claude Code auto titles | Sessions show the title Claude Code generated, in the session list, stats, export and archives (your own rename still wins) | | Prompts vs. agent updates | The Messages panel marks your typed prompts, agent updates, commands and injected context, with a "Show my prompts only" filter |

New in v1.29.0

| Feature | Description | |---------|-------------| | Z Code provider | Browse Z Code (Z.ai) sessions from ~/.zcode/cli/db/db.sqlite with titles, tool