Claude Code History Viewer

Browse, search, and analyze your Claude Code conversations — all offline.

Desktop app that reads ~/.claude conversation history with analytics, session boards, and real-time monitoring.

Website · Download · Report Bug

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

---

Table of Contents

• Features
• Installation
• Build from Source
• Usage
• Tech Stack
• Data Privacy
• Troubleshooting
• Contributing
• License

Features

Feature	Description
Conversation Browser	Navigate conversations by project/session with worktree grouping
Global Search	Search across all conversations instantly
Analytics Dashboard	Token usage stats and API cost calculation
Session Board	Multi-session visual analysis with pixel view and attribute brushing
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
Session Rename	Native session renaming with search integration
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

Download the latest release for your platform:

Platform	Download
macOS (Universal)	.dmg
Windows (x64)	.exe
Linux (x64)	.AppImage

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

Usage

1. Launch the app
2. It automatically scans ~/.claude for conversation data
3. Browse projects in the left sidebar
4. Click a session to view messages
5. Use tabs to switch between Messages, Analytics, Token Stats, Recent Edits, and Session Board

Tech Stack

Layer	Technology
Backend
Frontend
State
Build
i18n	5 languages

Data Privacy

100% offline. No conversation data is sent to any server. No analytics, no tracking, no telemetry.

Your data stays on your machine.

Troubleshooting

Problem	Solution
"No Claude data found"	Make sure ~/.claude exists with conversation history
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 tsc --build .        # TypeScript
   pnpm vitest run            # Tests
   pnpm lint                  # Lint

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.

---

If this project helps you, consider giving it a star!