Claude Code History Viewer

The unified history viewer for AI coding assistants.

Browse, search, and analyze conversations from Claude Code, Gemini CLI, Codex CLI, Cline, Cursor, Aider, and OpenCode — 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.

Seven assistants. One viewer. Switch between Claude Code, Gemini CLI, Codex CLI, Cline, Cursor, Aider, and OpenCode 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 | | 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 |

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

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, Codex CLI, Cline, Cursor, Aider, and OpenCode — 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 |

New in v1.10.0

| Feature | Description | |---------|-------------| | Monthly Calendar Heatmap | Activity heatmap split into monthly calendar blocks for clearer day-by-day visualization | | Session Management | Delete sessions (move to trash) and reveal JSONL files in system file explorer | | Copy Path | Copy project path from the project context menu | | Global Stats Date Filter | Filter analytics dashboard by date range | | Windows Portable | Portable .zip build — no installer required | | Per-tool Cards | Dedicated rendering cards for Bash, Read, Edit, Glob, Grep, Write, WebFetch, WebSearch, and Agent tools |

v1.9.0

| Feature | Description | |---------|-------------| | 4 New Providers | Added Gemini CLI, Cline, Cursor, and Aider — now supports 7 AI coding assistants | | WSL Support | Windows Subsystem for Linux integration — scan Claude Code projects inside WSL distros | | Enhanced Global Search | Project filter, LRU cache, aho-corasick multi-pattern optimization, and message navigation | | Zoom Controls | Keyboard shortcuts for zoom in/out |

v1.6.0

| Feature | Description | |---------|-------------| | WebUI Server Mode | Run as a headless web server with --serve — access from any browser, deploy on VPS/Docker | | Screenshot Capture | Long screenshot with range selection, preview modal, and multi-selection export | | Archive Management | Create, browse, rename, and export session archives with per-file download | | Accessibility | Full keyboard navigation, screen reader support, font scaling, and high contrast mode | | Mobile UI | Responsive 390px viewport support with bottom tab bar | | External Links | All links open in system browser instead of the app's WebView |

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 via Homebrew
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 18+, 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
`