2.4.3 · beta · local-first
Complete observability for Claude Code — without wrappers, SDKs, or cloud dependencies. Real-time cost tracking, tool latency, and subagent visibility while your session is live.
ObservAgent · localhost:4999
Total Cost
$2.47
this session
⬡
executor
$0.41 · 31 calls
⬡
verifier
$0.24 · 22 calls
5K
events/second throughput
The Problem
Claude sessions get
expensive and opaque
fast.
Claude writes JSONL transcripts, but they're not usable in real time. By the time you notice something's wrong, you've already burned the budget.
💸
Why did this run cost $3?
🐌
Which tool is slowing everything down?
🤫
Why did the agent silently fail?
🔍
What is the subagent actually doing?
Features
Everything you need to see
inside your Claude sessions.
💰
Real-Time Cost Tracking
Per-model token usage with automatic cost calculation. Watch spending accumulate as your session runs — catch runaway costs before they land on your bill.
per-model input/output split live
🔧
Tool Call Monitoring
Every tool call with execution time, success/failure status, and arguments. p50 and p95 latency breakdown so you know exactly which tools are slow.
p50/p95 latency error detection call history
🧩
Multi-Agent Visibility
Session timeline with subagent tracking and filtering. See the parent-child agent hierarchy, costs per agent, and independent tool activity side by side.
agent tree session filter timeline
🪝
Zero Integration
No wrappers. No SDK changes. No cloud. Works entirely via Claude Code hooks — one observagent init command installs everything automatically.
hooks-based local-first 127.0.0.1 only
Get Started
Up and running
in 30 seconds.
Three commands. No config files. No accounts. No cloud. Just visibility into what your agents are actually doing.
1
Install globally
Available on npm. Requires Node.js 18 or later.
2
Initialize hooks
Installs relay.py and registers Claude Code hooks automatically in ~/.claude/settings.json.
3
Start the dashboard
Run a Claude Code session — the dashboard shows live activity at localhost:4999.
$ npm install -g @darshannere/observagent
+ @darshannere/observagent@2.4.3
added 12 packages in 3.2s
$ observagent init
✓ relay.py installed to ~/.claude/observagent/
✓ PreToolUse hook registered
✓ PostToolUse hook registered
✓ SubagentStart hook registered
$ observagent start
✓ Server running on http://localhost:4999
Waiting for Claude Code session...
◉ Session detected — streaming live
$
Open Source · Free Forever
Stop flying blind.
Watch your agents work.
No accounts, no API keys, no telemetry. ObservAgent runs entirely on your machine and never sends data anywhere.
● Apache 2.0 · ● Local-first · ● No telemetry