Observability

Stream live PAI multi-agent activity and debugging traces via WebSocket.

1|Updated Jul 30, 2025
One-click install
npx skills add https://github.com/blackpwnguin/Personal-AI --skill observability-blackpwnguin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Observability
Source: https://github.com/blackpwnguin/Personal-AI/tree/main/.claude/skills/Observability
Command: npx skills add https://github.com/blackpwnguin/Personal-AI --skill observability-blackpwnguin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires bun, express, vue, vite, tailwindcss, typescript, lucide-vue-next, and includes scripts (resource) components.

What problem does it solve?

Real-time observability dashboard helps you monitor multi-agent activity in PAI, providing immediate visibility into sessions, tool usage, and event flow, so you can debug and optimize workflows quickly without sifting through logs.

Core Features & Use Cases

  • Real-time agent activity tracking: sessions, tool calls, hooks, and session timelines
  • WebSocket streaming for live updates to a UI
  • Lightweight, ephemeral data stream (in-memory)
  • Use case: debug multi-agent workflows or monitor agent performance during a run.

Quick Start

Use the observability skill to start the dashboard by running:

  • Start observability: ~/.claude/skills/observability/manage.sh start

Frequently Asked Questions about Observability

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

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

Real-time agent monitoring streams live sessions, tool calls, and event traces to a dashboard via WebSocket. Start observability with `~/.claude/skills/observability/manage.sh start` to view agent activity as it happens without parsing logs.

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

Yes. WebSocket streaming delivers live agent traces and debugging information to the dashboard, letting you inspect session timelines, tool usage, and event flow during execution for rapid workflow optimization.

What's the best way to track agent performance during a run?

The observability dashboard tracks sessions, tool calls, hooks, and session timelines in real-time. An in-memory data store captures live activity, making it lightweight for immediate performance visibility without log overhead.

Does the observability dashboard work with Express and Vue?

Yes. The dashboard runs on an Express server with a Vue-based UI built with Vite and Tailwind CSS, delivering a responsive real-time interface for monitoring agent activity.

What are the limitations of in-memory agent observability?

The data store is ephemeral and in-memory, so agent traces and activity logs persist only during the session. Stop the dashboard to clear stored data; use external logging for persistent records.