claude-code-history-viewer

---

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 calls, thinking and token usage — 31 assistants in total
Subagent cost in its session	A session’s billed tokens and cost now include the subagent runs it delegated to (Claude Code and Z Code); Conversation Only still shows the main thread
Faster session lists	Large Claude and Codex histories load their session lists several times faster

New in v1.28.0

Feature	Description
Current Cline sessions	Recent Cline releases (the VS Code extension included) store sessions in ~/.cline/data/sessions/; they now appear with titles, full transcripts, and token/cost stats. Cline, Roo Code and Kilo Code are also discovered on Windows
Kilo Code’s new store	Kilo Code’s OpenCode-core database (kilo.db) is read as its own provider, with live refresh and global stats
Accurate output tokens	Streamed Claude Code turns were undercounted by roughly 40%; each turn now counts its final usage once
Sessions pane & merged folders	The selected project’s sessions open in their own resizable column, and a folder used by several tools is one explorer row with provider chips
Cleaner transcripts	Tool calls are summarized in the collapsed row, repeated headers on continued turns are gone, and the header has one view switcher
Pricing refresh	Every rate re-verified against official pricing pages, fast/priority tiers priced, and retiring models flagged with their replacement
Transcript retention	Claude Code’s cleanupPeriodDays accepts long retention (e.g. 3650) and is clearly labelled as Claude Code’s setting — this app never deletes sessions

New in v1.23.0

Feature	Description
Grok CLI provider	Browse Grok CLI sessions from ~/.grok/sessions/, search across them, and include model/token usage in analytics
Session continuity	Related Claude transcript files are merged into one browsable conversation
WebUI deep links	Shareable links can open a specific session and message directly
Safer navigation and resume	Global-search selection syncs the owning project/session; unavailable worktree history stays visible with invalid resume actions disabled; Windows resume commands work in both CMD and PowerShell
Provider discovery fixes	Provider-specific and WSL-only scans no longer assume a native Claude data directory exists

New in v1.18.0

Feature	Description
Faster startup	Provider scanners now run concurrently instead of sequentially, so a locked SQLite database from a tool running alongside the viewer no longer stalls the whole scan — eliminating multi-second “Initializing app…” hangs
Search result context	Global search results now show which conversation each match belongs to, so matches that share the same text across sessions are easy to tell apart
Collapsible provider filter	The sidebar provider-filter panel can collapse to reclaim vertical space for the session list; the collapsed header still surfaces the active filter summary and count
Verifiable project names	Project identity prefers the on-disk folder name over a stale cwd recorded in old transcripts, so moved or subagent-recorded projects group correctly (one-time transparent re-scan)
Fixes	Exporting a subagent session now includes its messages instead of producing an empty file; OpenCode global sessions split by directory (and empty-directory sessions load correctly); the OpenCode session cache is bounded to prevent unbounded memory growth

New in v1.17.0

Feature	Description
Eleven new providers	Browse history from Continue.dev & PearAI (~/.continue / ~/.pearai session JSON), Goose (SQLite), Crush (per-project SQLite), llm (Simon Willison’s CLI), Amazon Q CLI, Open Interpreter (Codex-format rollouts), Qwen Code, Zed (Agent Panel threads — SQLite + Zstd), OpenHands, and Trae — plus Kilo Code via the Cline-family reader. Coverage grows from 14 to 25 assistants.
Kiro Windows path fix	Kiro CLI database now resolves via data_local_dir() (%LOCALAPPDATA%) on Windows instead of the incorrect AppData\Roaming

New in v1.16.0

Feature	Description
GitHub Copilot Provider	Read-only history from Copilot CLI (~/.copilot/session-state), Copilot Desktop, and VS Code Copilot Chat (workspaceStorage/.../chatSessions) — WSL-aware, with global search
Headless Session Export	New --export <session-id|/abs/path.jsonl> [--format html|json] [--output <file>] flag renders an HTML or JSON report and exits without launching the GUI — for SSH/CI use
One-Click Full Backup	An Archive Manager “Full Backup” card copies every session from all Claude Code projects into archives in one action, so history survives Claude Code’s automatic cleanup
Skill & Subagent Analytics	New “Most Used Skills” / “Most Used Subagents” sections break Claude Skill and Agent calls out by name, at project and global scope
Fixes	The font-size setting now applies to the whole app (message viewer, analytics, session board, settings), not just the left panel; session delete falls back to permanent deletion when the system trash is unavailable (e.g. Windows Recycle Bin disabled)

New in v1.15.0

Feature	Description
Three New Providers	Browse history from Cursor Agent (agent-transcripts, distinct from the Cursor IDE source), Kimi (~/.kimi, with kimi -r resume), and Kiro (SQLite-backed kiro-cli)
Codex Native Rename & Delete	Rename Codex sessions — the title is written to state_5.sqlite and shows in the codex resume picker, while the rollout transcript stays immutable — and delete sessions through a new in-app confirmation dialog; honors CODEX_HOME (sessions + archived)
Faster Scans & Search	Codex project lists scan only the session-meta line (mmap + memchr) and each provider scans independently, so a slow provider no longer blocks fast ones; in-session search indexing moved to a Web Worker so large sessions no longer freeze the UI
Accurate Claude Project Paths	Project name and the claude --resume working directory are now resolved from session metadata instead of the lossy folder encoding (one-time transparent re-scan on first launch)
Fixes	Removed blank gaps in the virtualized message history; fixed Kimi auto-refresh on macOS; fixed a Cursor scan crash on multibyte workspace-folder names

v1.14.0

Feature	Description
CodeBuddy Code Provider	Added CodeBuddy Code — browse its conversation history alongside your other AI coding assistants
WebUI Account Login	--serve mode gains optional account authentication (Argon2id + server-side sessions + CSRF), a read-only mode, and base-path support for reverse-proxy hosting
Persistent Message Filters	Role and content-type filters now persist across session switches and app restarts
Subagent Session Stability	Fixed multi-subagent click mapping and an occasional crash when opening large subagent sessions
Linux IME Input	Fixed ibus/fcitx input (Korean, Chinese, Japanese) in the search box on Linux

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”

Older releases: see CHANGELOG.md for v1.12.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? Move the existing app to Trash in Finder before installing via Homebrew to avoid conflicts. Choose one installation method — do not mix manual and Homebrew installs. Then run:

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

Build from Source

git clone https://github.com/jhlee0409/claude-code-history-viewer.git
cd claude-code-history-viewer

# Option 1: Using just (recommended)
brew install just    # or: cargo install just
just setup
just dev             # Development
just tauri-build     # Production build

# Option 2: Using pnpm directly
pnpm install
pnpm tauri:dev       # Development
pnpm tauri:build     # Production build

Requirements: Node.js 20.19+ (or 22.12+), pnpm, Rust toolchain

Server Mode (WebUI)

Run the viewer as a headless HTTP server — no desktop environment required. Ideal for VPS, remote servers, or Docker. The server binary embeds the frontend — a single file is all you need.

New to server deployment? See the full Server Mode Guide (한국어) for step-by-step instructions covering local testing, VPS setup, Docker, and more.

Quick Install

# Homebrew (macOS / Linux)
brew install jhlee0409/tap/cchv-server

# Or one-line script
curl -fsSL https://raw.githubusercontent.com/jhlee0409/claude-code-history-viewer/main/install-server.sh | sh

Both methods install cchv-server to your PATH.

Start the Server

cchv-server --serve

Output:

🔑 Auth token: b77f41d4-ec24-4102-8f7a-8a942d6dd4a0
   Open in browser: http://192.168.1.10:3727?token=b77f41d4-ec24-4102-8f7a-8a942d6dd4a0
👁 File watcher active: /home/user/.claude/projects
🚀 WebUI server running at http://0.0.0.0:3727

Open the URL in your browser — the token is saved automatically.

Pre-built Binaries

Platform	Asset
Linux x64	cchv-server-linux-x64.tar.gz
Linux ARM64	cchv-server-linux-arm64.tar.gz
macOS ARM	cchv-server-macos-arm64.tar.gz
macOS x64	cchv-server-macos-x64.tar.gz

Download from Releases.

CLI options:

Flag	Default	Description
--serve	—	Required. Starts the HTTP server instead of the desktop app
--port <number>	3727	Server port
--host <address>	0.0.0.0	Bind address (127.0.0.1 for local only)
--token <value>	auto (uuid v4)	Custom authentication token
--no-auth	—	Disable authentication (not recommended for public networks)
--dist <path>	embedded	Override built-in frontend with external dist/ directory

Authentication

All /api/* endpoints are protected by Bearer token authentication. The token is auto-generated on each server start and printed to stderr.

• Browser access: Use the ?token=... URL printed at startup. The token is saved to localStorage automatically.
• API access: Include Authorization: Bearer <token> header.
• Custom token: --token my-secret-token to set your own.
• Environment variable: CCHV_TOKEN=your-token cchv-server --serve (useful for systemd/Docker).
• Disable: --no-auth to skip authentication entirely (only use on trusted networks).

Real-time Updates

The server watches ~/.claude/projects/ for file changes and pushes updates to the browser via Server-Sent Events (SSE). When you use Claude Code in another terminal, the viewer updates automatically — no manual refresh needed.

Docker

docker compose up -d

Check the token after startup:

docker compose logs webui
# 🔑 Auth token: ... ← paste this URL in your browser

The docker-compose.yml mounts ~/.claude, ~/.codex, and ~/.local/share/opencode as read-only volumes.

The sample Docker setup mounts Claude, Codex, and OpenCode only. To browse another provider, add its local data directory as a read-only volume at the path that provider expects inside the container, then restart the container.

systemd Service

For persistent server on Linux, use the provided systemd template:

sudo cp contrib/cchv.service /etc/systemd/system/
sudo systemctl edit --full cchv.service   # Set User= to your username
sudo systemctl enable --now cchv.service

Build from Source (Server Only)

just serve-build           # Build frontend + embed into server binary
just serve-build-run       # Build and run (embedded assets)

# Or run in development (external dist/):
just serve-dev             # Build frontend + run server with --dist

Health Check

GET /health
→ { "status": "ok" }

Usage

1. Launch the app
2. It automatically scans for conversation data from all 31 supported providers (Claude Code, Codex CLI, Gemini CLI, Cursor, Cline, Continue.dev, Goose, Zed, Qwen Code, Amazon Q CLI, and more — see the provider table above)
3. Browse projects in the left sidebar — filter by provider using the tab bar
4. Click a session to view messages
5. Use tabs to switch between Messages, Analytics, Token Stats, Recent Edits, and Session Board

Command-line flags

Launch the app pre-focused on a specific session with one of these selectors:

# Full UUID
claude-code-history-viewer --session 1265cd74-caa9-472e-b343-c4f44b5cf12c

# UUID prefix (8+ hex-or-dash chars, up to 36) — first match wins
claude-code-history-viewer --session 1265cd74

# Equals form also works
claude-code-history-viewer --session=1265cd74

# Exact Claude session-folder name under ~/.claude/projects/
claude-code-history-viewer --session-folder my-project

# Case-insensitive substring match against session titles
claude-code-history-viewer --session-title "auth bug"

--session accepts a full UUID, UUID prefix, or absolute path to a .jsonl file. --session-folder matches an exact Claude session-folder name, while --session-title performs a case-insensitive title substring search and may show a picker when multiple sessions match. If multiple selectors are supplied, precedence is --session > --session-folder > --session-title.

The app also accepts these deep-link forms from a registered desktop environment:

file:///absolute/path/to/session.jsonl
claude-code-history-viewer://session/1265cd74-caa9-472e-b343-c4f44b5cf12c
claude-code-history-viewer://session-folder/my-project
claude-code-history-viewer://session-title/auth%20bug

The viewer scans every known project, navigates to the matching session, and falls back to normal startup if no session matches.

Accessibility

The app includes accessibility features for keyboard-only, low-vision, and screen-reader users.

• Keyboard-first navigation:
  • Skip links for Project Explorer, Main Content, Message Navigator, and Settings
  • Project tree navigation with ArrowUp/ArrowDown/Home/End, type-ahead search, and * to expand sibling groups
  • Message navigator navigation with ArrowUp/ArrowDown/Home/End and Enter to open the focused message
• Visual accessibility:
  • Persistent global font size scaling (90%, 100%, 110%, 120%, 130%)
  • High contrast mode toggle in settings
• Screen reader support:
  • Landmark and tree/list semantics (navigation, tree, treeitem, group, listbox, option)
  • Live announcements for status/loading and project tree navigation/selection changes
  • Inline keyboard-help descriptions via aria-describedby

Tech Stack

Layer	Technology
Backend
Frontend
State
Build
i18n	5 languages

Data Privacy

Desktop mode is local-first. Conversation files are read from local disk; no conversation data is uploaded, and there is no analytics, tracking, or telemetry.

Server mode intentionally serves local files to browsers and clients that can reach the server. Keep it bound to 127.0.0.1 for local-only use, or keep token authentication enabled before exposing it to a network.

Troubleshooting

Problem	Solution
“No Claude data found”	Make sure ~/.claude exists with conversation history
A provider is missing	Check its data path in the provider table. For an additional Claude directory, open Settings → Custom Claude Directories. In Docker, add the provider’s data directory as a read-only volume.
Cannot connect to the WebUI	cchv-server defaults to port 3727. Use the startup URL, check for port conflicts, and verify firewall or proxy rules when connecting remotely.
“Unauthorized” / HTTP 401	Use the token URL printed at startup or send Authorization: Bearer <token>. For a fixed token, use --token or CCHV_TOKEN.
Performance issues	Large histories may be slow initially — the app uses virtual scrolling
Update problems	If auto-updater fails, download manually from Releases

Contributing

Contributions are welcome! Here’s how to get started:

1. Fork the repository
2. Create a feature branch (git checkout -b feat/my-feature)
3. Run checks before committing:

   pnpm exec tsc --build .   # TypeScript
   pnpm vitest run            # Tests
   pnpm lint                  # Lint
   just rust-check-all        # Rust format, clippy, and tests
   pnpm run i18n:validate     # Locale consistency
   

4. Commit your changes (git commit -m 'feat: add my feature')
5. Push to the branch (git push origin feat/my-feature)
6. Open a Pull Request

See Development Commands for the full list of available commands.

License

MIT — free for personal and commercial use.

---