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:autoPlatform-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:buildRequirements: 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:linuxRequirements: Node.js 18+, pnpm, Rust toolchain, system libraries (WebKit, GTK)
- Launch the app
- It automatically scans
~/.claudefor conversation data - Browse projects in the left sidebar
- Click any session to view messages
- 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.
![@coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=64&v=4){kind=small}
