cc-viewer

Live session visualizer for Claude Code. Native Rust GUI that watches Claude Code's runtime directory and renders active sessions as an interactive scrollable timeline.

Screenshots

All sessions — "Show inactive" reveals every session across projects, with relative timestamps (green = active, gray = inactive):

Active sessions only — uncheck "Show inactive" to filter down to live sessions. Stats show 67 conversation groups across 3017 nodes:

Session view — selecting a session renders its conversation as a vertical stream of grouped turns. Each node shows the flow: User -> Assistant -> N tools:

Zoomed out — scroll to zoom out for a bird's-eye view of the full session timeline:

Features

• Live file watching — monitors Claude Code's runtime dir via inotify, updates in real-time
• Project tree sidebar — sessions grouped by project, with active/inactive filtering and timestamps
• Grouped conversation turns — collapses User/Assistant/Tool cycles into single nodes
• In-place expansion — click a node to reveal a terminal-like content log inside it
• Subagent collapsing — subagent records merge into single terminal-style nodes
• Linear layout — clean vertical stream matching the sequential nature of conversations
• GPU rendering — custom wgpu pipeline with SDF rounded rects, bezier edges, and glyphon text
• Smooth animations — animated expand/collapse, zoom-to-node, camera centering

Quick Start

# With Nix (recommended)
nix run github:jhhuh/cc-viewer

# Or in a dev shell
nix develop -c cargo run

Documentation

# Build and serve docs locally
nix run .#docs
# Opens at http://localhost:3000

Architecture

• eframe 0.31 — window management and egui overlay (sidebar, controls)
• Custom wgpu pipeline — node rects (SDF), edge curves (bezier tessellation), camera transforms
• glyphon 0.8 — GPU text rendering that scales naturally with camera zoom
• notify 8 — inotify-based file watching for incremental JSONL tailing

Data Sources

Sessions are read from Claude Code's standard paths:

• Session JSONL: ~/.claude/projects/{project}/{session_id}.jsonl
• Subagent JSONL: ~/.claude/projects/{project}/{session_id}/subagents/agent-{id}.jsonl
• Runtime dir: /tmp/claude-{UID}/ — symlinks to active session files

Building

Requires Rust toolchain and system libraries for Wayland/X11 + Vulkan/OpenGL.

# Nix handles all dependencies
nix build

# Or manually with cargo (ensure system deps are available)
cargo build --release

License

MIT