cc-dump

A live viewer for everything Claude Code sends to and receives from the Anthropic API. Run it, point Claude Code at it, and watch the full conversation — system prompts, tool calls, token costs, streaming responses — in a terminal UI.

Quickstart

# 1. Install (pulls all dependencies, including snarfx, from PyPI)
uv tool install "git+https://github.com/brandon-fryslie/cc-dump.git"

# 2. Start cc-dump — it prints the port it's listening on
cc-dump
# → Listening on: http://127.0.0.1:<PORT>

# 3. In another terminal, launch Claude Code pointed at cc-dump
ANTHROPIC_BASE_URL=http://127.0.0.1:<PORT> claude

That's it. Every request Claude Code makes now streams into the cc-dump UI, and is recorded to disk automatically so you can replay it later.

To replay a past session instead of proxying live traffic:

cc-dump --replay latest

Requirements

• uv — the installer used above. Install it with curl -LsSf https://astral.sh/uv/install.sh | sh.
• Python 3.10+ — uv will fetch a suitable Python for you if you don't have one.
• Claude Code — the thing you're monitoring.
• A terminal that renders 256 colors / truecolor (any modern terminal: iTerm2, Ghostty, Kitty, Windows Terminal, etc.).

No API keys, certificates, or config files are needed. cc-dump sits between Claude Code and Anthropic as a plain reverse proxy — Claude Code still uses your normal auth.

Optional: running inside tmux unlocks split-pane launching and auto-zoom (see the Tmux keys below).

Using it

cc-dump is keyboard-driven. The conversation scrolls in the main pane; every content type can be shown at three levels of detail, and panels along the side show cost and timeline analysis.

The core idea: 3 levels of detail

Each category of content (your messages, the assistant's, tool calls, etc.) can be displayed at one of three levels. Press a category's number key to cycle it:

You can also click any block marked ▶/▼ to expand or collapse just that one block.

Category keys

Hold Shift with a number to toggle its detail axis; the matching lowercase letter (q w e r t y u → categories 1–7) toggles expansion.

Navigation

Search

Searching automatically reveals matching content in full, even if that category was collapsed.

Panels & views

Presets & themes

Tmux (only when running inside tmux)

Everything else

Contributing or want the full CLI reference? Run cc-dump --help, and see ARCHITECTURE.md and CLAUDE.md.