v2.3.0 · Open Source · MIT License

The complete monitoring system for Claude Code

20/20
HINDSIGHT.

Name: Claude Hindsight
Author: Codestz

Every tool call. Every token. Every error. Every sub-agent. Visualize sessions in 3D, inspect code changes with syntax highlighting, preview screenshots, and track costs across all your projects. See everything Claude does.

GET STARTED READ THE DOCS GITHUB

QUICK INSTALL · MACOS & LINUX

brew tap codestz/tap

brew install claude-hindsight

claude-hindsight · localhost:7227

LIVE

01 / 04 Complete monitoring dashboard

SESSIONS

PROJECTS

TOTAL COST

$356

ERRORS

283

MODEL

opus-4-6

TOP TOOLS

Bash 1,821

Edit 894

Write 540

COST BY MODEL

opus-4-6 $279

sonnet-4-6 $62

haiku-4-5 $15

Conversations/day 57

Peak 14

Cache Read 465.7M

02 / 04 Two-panel session inspector

Execution List

user Refactor the auth module

think Planning the approach...

tool Read session.ts

result 148 lines · typescript

tool Edit session.ts

result −12 +28 lines

tool Bash npm test

result Exit code 1 · 2 failures

task Agent: TypeScript validator

● Tool · Edit RAW → RESULT

Edit

EDIT

session.ts −12 +28

−const session = cookies.get('sid');

+const token = jwt.verify(bearer);

+const session = token.payload;

03 / 04 Interactive 3D session graph

User Asst Tool Think

Drag: orbit · Scroll: zoom · Click: inspect

168 nodes · radial layout

04 / 04 Set it up once, it runs forever

terminal · ~/

$ claude-hindsight integrate --otel

✓ Installing Claude Code hooks...

✓ PreToolUse hook → added

✓ UserPromptSubmit hook → added

✓ OTLP exporter → :7228

✓ Done. Every session now auto-indexed.

ACTIVITY TIMELINE LIVE

14:21:05 HOOK session:start

14:21:11 OTLP tool:Glob

14:21:13 OTLP tool:Read

14:21:18 OTLP tool:Edit

14:21:22 OTLP tool:Bash

[02] CAPABILITIES // what claude-hindsight gives you

◈ ZERO SETUP

One binary.
No dependencies.

Install via Homebrew, Cargo, or download a pre-built binary. No Node.js, no Docker, no accounts — it just runs.

$ brew install claude-hindsight

✓ claude-hindsight 2.3.0 installed

$ claude-hindsight init

✓ Indexed 142 sessions across 8 projects

$ claude-hindsight serve --open

→ http://localhost:7227

✓ macOS & Linux ✓ Rust 1.75+ ✓ ~8 MB binary, zero runtime deps

◉ SESSION INSPECTOR

Two-panel inspector.
3D graph view.

Resizable split layout: compact execution list on the left, full node detail on the right. Switch to 3D graph view to visualize the entire session as an interactive force-directed graph with bloom lighting and node clustering. Preview screenshots, view syntax-highlighted code, navigate tool call ↔ result pairs.

// session_17b8f9a2.jsonl

│

├─ USER "Refactor the auth module"

│

└─ ASST thinking → tool calls

├─ THINK 892 tokens ──────────

├─ TOOL: Glob src/auth/**/*.ts

│ └─ RESULT 7 files matched

├─ TOOL: Bash cargo clippy

│ └─ RESULT exit 0 ✓

└─ SUBAGENT spawned → TypeScript validator

LIVE MONITOR

Watch sessions as
they happen.

claude-hindsight watch tails an active session in real time. New nodes stream in as Claude works — powered by SSE, not polling.

14:21:05 USER

14:21:11 THINK

14:21:13 TOOL

14:21:18 TOOL

14:21:22 SUB

◐ COST & ERROR TRACKING

Every dollar.
Every failure.

Track token costs per turn, per model, per project. Timeline scrubber shows cost distribution. Filter errors across all sessions with one click.

Glob 47 calls

Bash 31 calls

Edit 19 calls

TOTAL SESSIONS

142

ERRORS FOUND

⬡ TWO INTERFACES

Terminal or browser.
Same data, your choice.

The TUI lives in your terminal, the web dashboard opens in your browser. Both read the same SQLite index. Pick the one that fits your workflow.

TERMINAL UI

$ claude-hindsight

$ claude-hindsight list

$ claude-hindsight watch

$ claude-hindsight show <id>

ratatui · crossterm · j/k navigation

WEB DASHBOARD

$ claude-hindsight serve

→ localhost:7227

Sessions · Analytics

Live feed · Search

Vite + React Router · embedded in binary

◉ LOCAL FIRST

Your data never
leaves your machine.

Hindsight reads Claude's JSONL files directly. Nothing leaves your disk.

No network requests

No telemetry or tracking

No accounts, no sign-up

Read-only — never modifies sessions

ACID-compliant SQLite on disk

Memory-safe Rust throughout

⚡ REAL-TIME HOOKS

One command.
Every session captured.

claude-hindsight integrate --otel installs two Claude Code hooks and starts the OTLP daemon. From that moment, every tool call streams into the Activity Timeline automatically — zero manual steps.

✓ UserPromptSubmit + PreToolUse hooks ✓ OTLP telemetry on port :7228 ✓ Background daemon auto-starts

$ claude-hindsight integrate --otel

✓ Installing Claude Code hooks...

✓ PreToolUse hook → installed

✓ UserPromptSubmit hook → installed

✓ OTLP exporter → :7228

✓ Done. Sessions now auto-indexed.

[03] WHAT'S NEW IN v2.3.0 // latest release highlights

◎

3D Session Graph

Visualize entire sessions as interactive force-directed graphs. Radial DAG layout, bloom lighting, click-to-focus camera. Powered by Three.js + WebGL.

◉

Image Previews

Screenshots embedded in tool results render as inline previews with expand-to-lightbox. Base64 data decoded directly — works even after files are deleted.

◈

Smart Tool Rendering

Read, Edit, Write, Bash — each tool type gets a specialized display. MCP tools show server badges. Syntax highlighting for 8+ languages.

↻

Task Notifications

Sub-agent completions parsed from XML into structured cards with status, token usage, duration, and markdown result rendering.

⊕

Timeline Scrubber

Horizontal timeline bar with colored node markers. Click anywhere to jump. Token-per-turn cost bars overlay in the background.

⚡

Unified Error Tracking

Global error count consistent across Dashboard and Activity. Errors tab loads failure events separately so they're always visible.

[04] UP AND RUNNING IN 60 SECONDS

INSTALL

One command via Homebrew or cargo install. Pre-built binaries have zero external dependencies — no Node.js, no Python, nothing.

$ brew tap codestz/tap

==> Tapping codestz/tap...

$ brew install claude-hindsight

✓ claude-hindsight 2.3.0 installed

INDEX

Scan ~/.claude/projects/ and build a local SQLite index. Takes seconds even for hundreds of sessions.

$ claude-hindsight init

Scanning ~/.claude/projects/

✓ Indexed 142 sessions, 8 projects

✓ Index → ~/.local/share/claude-hindsight/

EXPLORE

Launch the web dashboard, fire up the TUI, or watch an active session stream live. Your sessions, your way.

$ claude-hindsight serve --open

→ http://localhost:7227

Press Ctrl+C to stop

$ claude-hindsight watch

INTEGRATE

One command installs Claude Code hooks and starts the OTLP daemon. Every future session is indexed and streamed live — automatically.

$ claude-hindsight integrate --otel

✓ PreToolUse hook → installed

✓ OTLP exporter → :7228

✓ Done. Sessions auto-indexed.

20/20HINDSIGHT.

One binary.No dependencies.

Two-panel inspector.3D graph view.

Watch sessions asthey happen.

Every dollar.Every failure.

Terminal or browser.Same data, your choice.

Your data neverleaves your machine.

One command.Every session captured.

20/20
HINDSIGHT.

One binary.
No dependencies.

Two-panel inspector.
3D graph view.

Watch sessions as
they happen.

Every dollar.
Every failure.

Terminal or browser.
Same data, your choice.

Your data never
leaves your machine.

One command.
Every session captured.