claude-code-chat-browser 0.1.0

Browse your Claude Code chat history

Claude Code Chat Browser (CCCB)

A lightweight desktop app for browsing, searching, and copying text from your Claude Code chat history. No cloud, no tracking—everything stays local.

Features

• Browse chats — Organized by project with expandable groups
• Full-text search — Find conversations by name or content, with navigation wrapping
• View transcripts — Syntax-highlighted code blocks, expandable thinking sections, tool visualizations, message numbering
• Copy to clipboard — Extract text, code, or entire conversations
• Light/Dark mode — Toggle theme with persistent preference
• Metadata — See message count, token usage, and timestamps
• Persistent state — Remembers your last opened chat and theme preference

Install

pip install claude-code-chat-browser
cccb

From source:

git clone [e-mail]:rick-does/claude-code-chat-browser.git
cd claude-code-chat-browser
pip install -e .
cccb

Usage

• Search — Type in the sidebar to filter chats
• Project filter — Select a project to narrow the list
• Transcript search — Use the search box in the main pane to find text within a chat; navigate with arrow buttons (wraps around at edges)
• Message numbering — Each user/assistant message is numbered for easy reference when copying sections
• Light/Dark mode — Click the theme toggle button (◑/◯) next to the refresh button to switch themes
• Copy — Right-click to copy selected text or entire sections
• GitHub — Click the footer link to report issues or request features

Linux / WSL

On Linux and WSL, CCCB runs as a local web server instead of a desktop app. Open your browser to the URL printed on startup.

WSL: CCCB automatically opens your Windows browser.

Remote Linux server (SSH): Use an SSH tunnel so you can access the UI from your local browser — no firewall changes needed:

ssh -L 5000:localhost:5000 user@your-server

Then open http://localhost:5000 in your local browser while the tunnel is active.

Development

cccb                # Run normally
cccb --dev          # Run with auto-reload on file changes
cccb --serve        # Force browser mode (test headless on any platform)

Standalone Executable

build.py produces a self-contained binary via PyInstaller (no Python required):

pip install pyinstaller
python build_exe.py

Output: dist/CCB.exe (Windows), dist/CCB (macOS/Linux)

Architecture

• Backend: Python with in-memory indexing
• Frontend: Alpine.js + vanilla HTML/CSS
• Framework: pywebview (Windows/Mac), Flask (Linux/WSL)
• Data source: ~/.claude (Claude Code chat history)

Data & Privacy

CCCB reads from your local ~/.claude directory only—no data is sent anywhere. The app runs entirely offline.

License

MIT