# Agents Observe

> Real-time observability dashboard for Claude Code agents with powerful filtering, searching, and visualization of multi-agent sessions.

Agents Observe is a real-time observability dashboard for Claude Code agents that captures every hook event as it happens and streams it to a live dashboard. It provides full visibility into multi-agent sessions, including tool calls, subagent hierarchies, file operations, and command executions. The server and dashboard run locally or remotely via Docker, allowing multiple Claude Code instances to log full session data using hooks instead of OTEL for a complete picture of agent actions.

- **Real-time event streaming** — *Watch tool calls stream in as they happen, with PreToolUse → PostToolUse events merged into single rows for clarity.*
- **Multi-agent hierarchy visualization** — *See the full agent tree showing which subagent was spawned by which parent, making parallel execution transparent.*
- **Powerful filtering and search** — *Filter by agent, tool type, or search across all events to quickly find relevant activity.*
- **Full payload inspection** — *Expand any event to see the complete payload, command, and result for deep debugging.*
- **Historical session browsing** — *Browse past sessions with human-readable names (e.g., "twinkly-hugging-dragon") and trace exact event sequences.*
- **Plugin installation** — *Install via `claude plugin install agents-observe` for zero-config setup; the server auto-starts as a Docker container on next session.*
- **Standalone/dev mode** — *Clone the repo, run `just start` for Docker or `just dev` for hot-reload development with separate client and server processes.*
- **WebSocket live updates** — *The React dashboard receives real-time events via WebSocket with automatic reconnection every 3 seconds on disconnect.*
- **SQLite persistence** — *All events are stored in a local SQLite database, enabling cross-session pattern analysis and post-hoc debugging.*
- **MCP server integration** — *Includes an MCP server configuration and `/observe` skill commands for checking dashboard status from within Claude Code.*

## Features
- Real-time event streaming via WebSocket
- Multi-agent hierarchy visualization
- Filter by agent, tool type, or search across events
- Full payload inspection for tool calls
- Historical session browsing with human-readable names
- Claude Code plugin installation support
- Docker-based server deployment
- SQLite event persistence
- MCP server integration
- PreToolUse and PostToolUse event merging
- Auto-reconnecting WebSocket client
- Project-level and user-level hook configuration

## Integrations
Claude Code, Docker, Node.js, SQLite, React, WebSocket, Hono, shadcn

## Platforms
MACOS, WEB, API, CLI

## Pricing
Open Source

## Version
v0.7.4

## Links
- Website: https://github.com/simple10/agents-observe
- Documentation: https://github.com/simple10/agents-observe
- Repository: https://github.com/simple10/agents-observe
- EveryDev.ai: https://www.everydev.ai/tools/agents-observe