Claude Code Hooks Multi-Agent Observability

Stale
GitHub Python No License

Description

A real-time observability toolkit for Claude Code agents that tracks hook events to monitor multi-agent coding workflows.

Key Features

  • Real-time event streaming via WebSocket from Claude Code hook events to a Vue dashboard
  • Supports all 12 Claude Code hook event types (PreToolUse, PostToolUse, SessionStart, etc.)
  • Multi-agent session tracking with colored agent identification and event filtering
  • SQLite-backed event storage with live pulse chart for activity visualization
  • Chat transcript viewer and scroll-controlled event timeline
  • Copy-paste .claude directory integration — works across multiple projects in minutes

Use Cases

💡 Monitor multi-agent orchestration workflows with Opus 4.6 parallel agent teams
💡 Debug agent behavior by tracing tool calls, task handoffs, and lifecycle events
💡 Audit agent sessions for compliance and performance analysis
💡 Observe Claude Code agents running across different projects from a single dashboard

Tags

observability claude-code hooks monitoring python

Categories

📊 Observability 💻 Coding Agent

Quick Start

1. Install prerequisites: Claude Code CLI, Astral uv, Bun/npm, and ANTHROPIC_API_KEY.
2. Clone the repo and run `just start` or `./scripts/start-system.sh`.
3. Open http://localhost:5173 to view the dashboard.
4. In Claude Code, run any command (e.g., `git ls-files`) and watch events stream live.
5. Copy the `.claude` folder to other projects you want to monitor.
Visit GitHub

Related Projects