claude-code-sniffer

A terminal UI for monitoring Claude Code sessions in real time.

What it does

Tails the JSONL log that Claude Code writes to ~/.claude/projects/ and renders the conversation in a three-pane TUI — without interrupting the running session.

┌─────────────────┬───────────────────────────┬────────────────────────┐
│ Stats           │ Rounds                    │ Inspector              │
│                 │                           │                        │
│ Tools:  12      │ ├── 👤 User               │ Content                │
│ Subs:    2      │ ├── 🤖 Claude             │ ───────────────────    │
│                 │ │   ├── ⚙ Bash            │ <message text>         │
│ In:    4 200    │ │   └── ⚙ Read            │                        │
│ Out:     800    │ └── 👤 User               │ Input:                 │
│                 │                           │ { "command": "ls" }    │
└─────────────────┴───────────────────────────┴────────────────────────┘

Requirements

• Rust (edition 2024)
• An active or recent Claude Code session

Run

cargo run --release

The app automatically picks the most recently modified session file. No arguments needed.

Keybindings

Key	Action
Tab	Cycle focus: Sidebar → Rounds → Inspector
j / ↓	Next round / scroll down in Inspector
k / ↑	Previous round / scroll up in Inspector
PageDown	Scroll active pane down 5 lines
PageUp	Scroll active pane up 5 lines
q / Esc	Quit