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, and ForgeCode — as a desktop app or headless server. 100% offline.
Website · Download · Report Bug
Languages: English | 한국어 | 日本語 | 中文 (简体) | 中文 (繁體)
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://...install-server.sh | sh
cchv-server --serve # → http://localhost:3727
See Server Mode for Docker, VPS, and systemd setup.
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.
Nine assistants. One viewer. Switch between Claude Code, Gemini CLI, Antigravity, Codex CLI, Cline, Cursor, Aider, OpenCode, and ForgeCode 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 |
| 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 | ~/.cline/tasks/ | Task-based conversation history |
| Cursor | ~/.cursor/ | Composer and chat conversations |
| 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 |
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 Claude Code, Gemini CLI, Antigravity, Codex CLI, Cline, Cursor, Aider, OpenCode, and ForgeCode — 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.13.0
| Feature | Description |
|---------|-------------|
| macOS Custom Title Bar | Draggable overlay header replaces the legacy macOS title bar for consistent screen-space use; Linux/Windows unaffected |
| Session Source Filter | Filter sessions by where they were created — CLI, VS Code, or Desktop — using Claude Code's entrypoint field |
| Codex Resume Support | Right-click "Copy Resume Command" now works for Codex sessions and prefixes cd '<cwd>' && so paste-and-run lands in the original directory |
| Pricing Accuracy | Fixed claude-opus-4-7 3× overcharge; added gpt-5.4 / gpt-5.5 pricing with Codex cached-token handling |
| macOS Updater Reliability | Native OS-level relaunch fallback for the Tauri v2 macOS relaunch bug — no more "please quit and reopen" |
v1.12.0
| Feature | Description |
|---------|-------------|
| Two New Providers | Added Antigravity and ForgeCode — now supports 9 AI coding assistants |
| External Session Launch | New --session <uuid> CLI flag with single-instance enforcement and macOS Apple Events for re-invocation |
| Sub-agent Filter | Toggle sub-agent messages on/off from the header dropdown |
| Context Menu Polish | Right-click menus rendered in portal for cursor-precise anchoring; clamp to panel bounds; close on scroll |
| Custom Directory | Custom Claude directory selection now applies instantly without restart |
v1.11.0
| Feature | Description |
|---------|-------------|
| Auto-refresh Sessions | Session list auto-refreshes on file changes; auto-scroll to bottom on new messages |
| Project Panel Search | Search box plus horizontal scrollbar for long project names |
| Session Right-click Menu | Copy session ID, resume command, file path; delete session; show JSONL file; native rename with search integration |
| Sub-agent Conversation History | View sub-agent (sidechain) conversation history |
| Custom Claude Config Directories | Support directories outside ~/.claude |
Older releases: see CHANGELOG.md for v1.10.0 and earlier.
More
| Feature | Description | |---------|-------------| | Session Context Menu | Copy session ID, resume command, file path; delete session, show JSONL file; native rename with search integration | | ANSI Color Rendering | Terminal output displayed with original ANSI colors | | Multi-language | English, Korean, Japanese, Chinese (Simplified & Traditional) | | Recent Edits | View file modification history and restore | | Auto-update | Built-in updater with skip/postpone options |
Installation
Homebrew (macOS)
brew tap jhlee0409/tap
brew install --cask claude-code-history-viewer
Or install directly with the full cask path:
brew install --cask jhlee0409/tap/claude-code-history-viewer
If you see No Cask with this name exists, run the full cask path command above.
To upgrade:
brew upgrade --cask claude-code-history-viewer
To uninstall:
brew uninstall --cask claude-code-history-viewer
Migrating from manual (.dmg) installation? Remove the existing app before installing via Homebrew to avoid conflicts. Choose one installation method — do not mix manual and Homebrew installs.
# Remove the manually installed app first rm -rf "/Applications/Claude Code History Viewer.app" # Then install v