Agents Observe

Agents Observe

Real-time observability dashboard for Claude Code and Codex agents.

Includes powerful filtering, searching, and visualization of multi-agent sessions with full replay and token usage stats.

Demo video
Version 0.9.7 adds token usage and cost breakdowns in session stats.

Quick Start

Install as a claude code plugin:

Default dashboard URL:

Data Location

By default, the SQLite DB and logs live under:

- $CLAUDE_PLUGIN_DATA when running as a Claude plugin. Claude Code names this dir
  - — so a marketplace install lands at
  ~/.claude/plugins/data/agents-observe-agents-observe/, and a --plugin-dir
  install lands at ~/.claude/plugins/data/agents-observe-inline/.
- ~/.agents-observe/ when running outside Claude (Codex, manual CLI, dev).

The DB sits at /data/observe.db, logs at /logs/.

To pin the location somewhere else — e.g. an external volume — set
AGENTS_OBSERVE_LOCAL_DATA_ROOT in your ~/.claude/settings.json:

Upgrading the plugin preserves your DB automatically. If you're upgrading
from a pre-fix version (≤ 0.9.8) the server scans for a DB under the old
version-scoped install dir on first start and copies it into the stable
location. See /data/.migrated-from.json for the record.

Prerequisites

- Docker — the server runs as a container
- Node.js — hook scripts run via node
- Bash - hooks are configured to use hooks.sh for fast fire and forget event logging

If docker, node, or bash are not installed on your host, the plugin will fail to properly load.

Use the /observe debug claude command to help troubleshoot and fix installation issues.

Plugin Skills

Why observability matters

When Claude Code runs autonomously — spawning subagents, calling tools, reading files, executing commands — you have no visibility into what's actually happening. The…