This project provides a real-time observability system for Claude Code agents, enabling detailed monitoring and visualization of agent behavior through hook event tracking. It's designed for developers and researchers working with Claude Code who need to understand and debug multi-agent interactions.

How It Works

The system captures Claude Code hook events via Python scripts, which then send these events via HTTP POST to a Bun-based TypeScript server. The server stores events in an SQLite database and broadcasts them in real-time over WebSockets to a Vue 3 client. This architecture allows for granular tracking of agent actions, session management, and live visualization of event streams.

Quick Start & Requirements

• Install: Clone the repository and run ./scripts/start-system.sh from the root directory.
• Prerequisites: Claude Code, uv, Bun (or npm/yarn), Anthropic API Key (as ANTHROPIC_API_KEY). Optional: OpenAI API Key, ElevenLabs API Key.
• Setup: Copy the .claude directory to your project root and configure settings.json.
• Demo: Open http://localhost:5173 in your browser after starting the system.
• Docs: Claude Code documentation for hook integration.

Highlighted Details

• Real-time event streaming via WebSockets.
• Vue 3 client with live pulse charts, filtering, and chat transcript viewing.
• Python hook scripts for event capture, including validation and blocking of dangerous commands.
• Bun server with SQLite backend for efficient data storage and retrieval.
• Supports multiple concurrent agents with session tracking.

Maintenance & Community

The project is maintained by disler. Further community engagement details are not explicitly provided in the README.

Licensing & Compatibility

The project's license is not explicitly stated in the README. Compatibility for commercial use or closed-source linking is not specified.

Limitations & Caveats

The README mentions that hook scripts might require absolute paths for commands, and provides a /convert_paths_absolute utility within Claude Code to address this. Some optional API keys (OpenAI, ElevenLabs) are mentioned for extended functionality.