cclog

Browse, search, and analyze your Claude Code conversation history.

Install

pip install claude-log

Usage

cclog                          # opens browser at localhost:9117
cclog --port 3000              # custom port
cclog --no-open                # don't auto-open browser
cclog --host 0.0.0.0           # bind to all interfaces
cclog --claude-home /path/to   # custom claude directory

Features

• Search — full-text search across all conversations via Whoosh
• Browse — conversations grouped by project with auto-summaries
• Analytics — token usage, estimated cost, model breakdown, activity heatmap
• Tag & organize — name, tag, and favorite conversations
• Export / Import — export per project or per chat, import on any machine
• Resume — copy claude --resume <id> command from any conversation
• Read-only — never modifies ~/.claude/, metadata stored separately in ~/.local/share/cclog/
• API — full REST API with Swagger docs at /docs

How it works

cclog reads your Claude Code history from ~/.claude/ in read-only mode and serves a web UI.

~/.claude/                      <- read-only (never modified)
├── history.jsonl
├── projects/
│   └── -Users-you-project/
│       ├── session-id.jsonl    <- full conversation
│       └── sessions-index.json
└── sessions/

~/.local/share/cclog/           <- cclog's data
├── metadata.json               <- tags, renames, favorites
└── index/                      <- search index

API

Interactive docs at /docs (Swagger UI).

Tech

Python, FastAPI, Whoosh, Jinja2

License

MIT