cscope

A jazzy terminal UI for browsing, searching, and inspecting Claude Code session history across all your projects. Native Rust, zero network, keyboard-driven.

  ▄████▄    ██████  ▄████▄   ▒█████   ██▓███  ▓█████
 ▒██▀ ▀█  ▒██    ▒ ▒██▀ ▀█  ▒██▒  ██▒▓██░  ██▒▓█   ▀
 ▒▓█    ▄ ░ ▓██▄   ▒▓█    ▄ ▒██░  ██▒▓██░ ██▓▒▒███
 ▒▓▓▄ ▄██▒  ▒   ██▒▒▓▓▄ ▄██▒▒██   ██░▒██▄█▓▒ ▒▒▓█  ▄
 ▒ ▓███▀ ░▒██████▒▒▒ ▓███▀ ░░ ████▓▒░▒██▒ ░  ░░▒████▒

What it does

Walks ~/.claude/projects/*, parses each project's sessions-index.json, and streams session JSONL on demand. Two-pane layout: collapsible project tree on the left, color-coded transcript on the right.

• [user] lime · [assistant] neutral · [tool_use] gold · [tool_result] dim · [thinking] violet · [summary] cyan
• Animated rainbow banner, hot-pink selection highlight, neon focus borders
• Per-session token totals + cost estimate (Anthropic public rates, model-aware)
• Filter by free-text, sort by recent / message count / alpha, flat or tree view

Run

cargo run --release

Flags

Keys

Observability

Every keypress, render, JSONL parse error, and session load duration is tracked. The /metrics endpoint serves Prometheus text format on port 9090 (or --metrics-port):

cscope_build_info{version="0.1.0"} 1
cscope_uptime_seconds 12.345
cscope_sessions_total 142
cscope_projects_total 15
cscope_messages_loaded_total 0
cscope_jsonl_parse_errors_total 0
cscope_keypresses_total 0
cscope_render_seconds_sum 0.000000
cscope_render_seconds_count 0
cscope_session_load_seconds_sum 0.000000
cscope_session_load_seconds_count 0

Logs are JSON-per-line, rotated by your filesystem of choice. Tail with jq:

tail -f ~/Library/Application\ Support/cscope/cscope.log | jq .

Build

cargo build --release
# binary at target/release/cscope

Stack

• ratatui 0.30 + ratatui-widgets 0.3 + crossterm for the TUI
• tracing + tracing-subscriber (JSON layer) for structured logging
• tiny_http for the /metrics server
• serde_json for streaming JSONL
• walkdir + dirs for filesystem discovery

No async runtime, no API calls, no config file required. Read-only — cscope never writes to ~/.claude/.