Observability

Monitor PAI multi-agent sessions and tool calls via a WebSocket dashboard.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/mikegil/MaxAI --skill observability-mikegil
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Observability
Source: https://github.com/mikegil/MaxAI/tree/main/.claude/Skills/Observability
Command: npx skills add https://github.com/mikegil/MaxAI --skill observability-mikegil

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Real-time visibility into multi-agent activity is essential for debugging, auditing, and optimizing collaborative workflows. This Skill delivers a live dashboard and streaming data so you can see agent sessions, tool calls, and events as they happen, reducing debugging time and guesswork.

Core Features & Use Cases

  • Real-Time Monitoring: Track agent sessions, tool usage, and hook events as they occur.
  • Live Dashboard & WebSocket Stream: View a synchronized UI and receive streaming updates without manual log crawling.
  • Ephemeral by Design: No database; the dashboard starts fresh on each launch for quick debugging sessions.

Quick Start

  • Start the observability server and dashboard: ~/.claude/Skills/observability/manage.sh start
  • Stop everything: ~/.claude/Skills/observability/manage.sh stop
  • Restart observability: ~/.claude/Skills/observability/manage.sh restart
  • Check status: ~/.claude/Skills/observability/manage.sh status

Frequently Asked Questions about Observability

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I monitor agent activity in real time?

Real-time monitoring tracks agent sessions, tool calls, and events as they happen through a live WebSocket-connected dashboard. Start the observability server with ~/.claude/Skills/observability/manage.sh start to begin streaming events without database overhead.

Can I use WebSocket streaming to debug multi-agent workflows?

Yes. WebSocket streaming delivers live event updates to a Vue client, letting you watch agent sessions and tool execution unfold. This ephemeral approach resets on each launch, ideal for quick debugging iterations without persistent storage.

What's the best way to set up a real-time observability dashboard for PAI?

Deploy the included Bun + Express + TypeScript server and Vue client using manage.sh. The server watches filesystem event sources, streams updates via WebSocket, and stores data in memory only—no database configuration needed.

Do I need a database to run the observability dashboard?

No. The Skill uses ephemeral in-memory storage by design, so the dashboard starts fresh each time you launch it. This eliminates database setup and keeps debugging sessions lightweight.

How do I start, stop, or check the status of observability monitoring?

Use the manage.sh script: start with ~/.claude/Skills/observability/manage.sh start, stop with stop, restart with restart, or check status with status. All commands control the integrated server and dashboard.

What happens when I restart the observability dashboard?

Restarting with ~/.claude/Skills/observability/manage.sh restart stops and restarts the Bun + Express server and Vue client. In-memory event data clears, giving you a fresh dashboard for the next monitoring session.