v2.1 · beta · local-first

Watch Every
AI Agent.
In Real Time.

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.

Apache 2.0
Node ≥18
Zero telemetry
ObservAgent · localhost:4999
LIVE
Total Cost
$2.47
this session
Tool Calls
142
p95: 48ms
Agents
3
2 active
Tool Activity 142 events
Read
src/components/AgentTree.tsx
12ms
Edit
frontend/src/App.tsx
8ms
Bash
npm run build --prefix frontend
running
Glob
**/*.tsx
3ms
Bash
tsc --noEmit — 2 errors
204ms
Read
package.json
2ms
main
$1.82 · 89 calls
executor
$0.41 · 31 calls
verifier
$0.24 · 22 calls
5K
events/second throughput
<50
ms query latency
~50
MB memory baseline
0%
telemetry. ever.
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.

Terminal
$ npm install -g @darshannere/observagent
+ @darshannere/observagent@2.1.0
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