A desktop app to browse and search your Claude Code conversation history stored in ~/.claude.

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

⚠️Beta software - Things might break or change

Claude Code stores conversation history in JSONL files scattered across ~/.claude/projects/. These are hard to read and search through. This app gives you a proper interface to browse your conversations, see usage stats, and find old discussions.

Browse projects and view conversations with syntax-highlighted code blocks

Activity heatmap and tool usage statistics to understand your usage patterns

Per-project token usage breakdown and session-level analysis

Browse conversations: Navigate through projects and sessions with a file tree on the left, conversation view on the right.

Search and filter: Find specific conversations or messages across your entire history.

Usage analytics: See which projects you use most, token usage over time, and activity patterns. Useful for understanding your Claude Code habits.

Better reading experience: Syntax highlighted code blocks, properly formatted diffs, and readable message threads instead of raw JSONL.

Tool output visualization: Web search results, git operations, and terminal output are displayed in a readable format.

The app also handles large conversation histories without freezing up, and auto-refreshes when new conversations are added.

Get the latest version from Releases.

🌍 Language Support: The app includes complete English language support by default, with additional support for Korean, Japanese, and Chinese.

git clone https://github.com/jhlee0409/claude-code-history-viewer.git cd claude-code-history-viewer # Run the setup script to install all dependencies ./scripts/setup-build-env.sh # Build the application (auto-detects your platform) pnpm tauri:build:auto

Platform-specific builds:

• macOS: pnpm tauri:build (universal binary for Intel + Apple Silicon)
• Linux: pnpm tauri:build:linux (DEB, RPM, AppImage)

git clone https://github.com/jhlee0409/claude-code-history-viewer.git cd claude-code-history-viewer # Install dependencies pnpm install # Add required Rust targets for universal builds rustup target add x86_64-apple-darwin # Build pnpm tauri:build

Requirements: Node.js 18+, pnpm, Rust toolchain, Xcode Command Line Tools

See LINUX_BUILD.md for detailed Linux build instructions.

git clone https://github.com/jhlee0409/claude-code-history-viewer.git cd claude-code-history-viewer pnpm install pnpm tauri:build:linux

Requirements: Node.js 18+, pnpm, Rust toolchain, system libraries (WebKit, GTK)

1. Launch the app
2. It automatically scans ~/.claude for conversation data
3. Browse projects in the left sidebar
4. Click any session to view messages
5. Check the analytics tab for usage insights

• Linux and macOS support (Windows support planned)
• Beta software - expect some rough edges
• Large conversation histories (thousands of messages) might be slow to load initially
• Auto-update system is still being tested

Everything runs locally. No data is sent to any servers. The app only reads files from your ~/.claude directory.

The app expects this structure:

~/.claude/ ├── projects/ # Project conversations │ └── [project-name]/ │ └── *.jsonl # Conversation files ├── ide/ # IDE data ├── statsig/ # Analytics └── todos/ # Todo lists 

"No Claude data found": Make sure you've used Claude Code and have some conversation history. Check that ~/.claude exists.

Performance issues: Try closing other apps if you have very large conversation histories. The app loads everything into memory for now.

Update problems: Beta auto-updater might be flaky. Download manually from releases if needed.

Pull requests welcome. This is a side project so response times might vary.

Built with Tauri (Rust + React). UI uses Tailwind CSS and Radix components.

MIT License - see LICENSE file.

Questions or issues?Open an issue with details about your setup and what went wrong.