ccx

Session viewer for coding agents — Browse, search, and export conversations from Claude Code and Codex.

ccx web

Opens a browser at localhost:8080. That's it.

Screenshots

More screenshots

What it does

ccx reads session files from ~/.claude/ and ~/.codex/ and gives you a fast, keyboard-driven interface to browse them.

• Multi-provider — Claude Code + Codex sessions merged by project, with provider badges
• Two-panel navigation — Projects → Sessions → Conversation tree
• Live tail — Watch active sessions update in real-time
• In-session search — Filter by User, Response, Tools, Agents, Thinking
• Memory inspector — View CLAUDE.md, MEMORY.md, AGENTS.md per project
• Brief export — Conversation-only mode strips tool noise
• Export — HTML, Markdown, Org-mode, JSON
• Provider filter — --provider cc or --provider cx on any command
• Date filter — --after 2026-03-01 --before 2026-04-01
• Keyboard shortcuts — j/k scroll, / search, z fold, r refresh, d theme

Single binary, zero dependencies, read-only. Never touches your session files.

Install

curl -fsSL https://raw.githubusercontent.com/thevibeworks/ccx/main/install.sh | bash

Or via Go:

go install github.com/thevibeworks/ccx/cmd/ccx@latest

Or build from source:

git clone https://github.com/thevibeworks/ccx
cd ccx && make build
./bin/ccx web

Usage

ccx web                          # Start web UI (recommended)
ccx projects                     # List all projects
ccx sessions                     # List recent sessions
ccx sessions --provider=cx       # Codex sessions only
ccx sessions --after=2026-03-01  # Date filtered
ccx view [session]               # View in terminal
ccx export -f html --brief       # Export conversation-only HTML
ccx search "auth bug"            # Search across sessions + memory
ccx fork abc123                  # Fork session to current project
ccx doctor                       # Check setup

Configuration

# ~/.config/ccx/config.yaml
theme: dark
show_thinking: collapsed
default_format: html
providers:
  claude-code:
    enabled: true
  codex:
    enabled: true

Override provider homes:

ccx --claude-home /path web
ccx --codex-home /path web

Data safety

ccx treats all agent data as read-only. Writes only to its own directories:

• $XDG_CONFIG_HOME/ccx/ — config
• $XDG_DATA_HOME/ccx/ — stars database

Claude Code skill

ccx ships as a Claude Code skill. Install alongside the binary:

curl -fsSL https://raw.githubusercontent.com/thevibeworks/ccx/main/install.sh | bash

Or manually copy skills/ccx/ to ~/.claude/skills/ccx/.

Credits

Inspired by Simon Willison's claude-code-transcripts. Rebuilt in Go with live tailing, multi-provider support, and a web UI.

License

Apache 2.0

---

Built by thevibeworks · @ericwang42