AgentObservability 用于实时监控和调试多智能体 Claude Code 会话,可追踪并行子智能体执行、分析工具使用模式并可视化会话流程。
主要能力:实时展示多个智能体(如 kai、designer、engineer)并行运行的泳道、按时间排列的事件时间线、工具使用图表以及会话生命周期追踪;支持按智能体名称、事件类型、会话 ID 过滤,并可搜索事件载荷。捕获的事件类型包括 SessionStart、UserPromptSubmit、PreToolUse、PostToolUse、Stop、SubagentStop、SessionEnd。
使用方式:需先安装 Bun 运行时、配置 Claude Code hooks 并设置 PAI_DIR 环境变量。快速设置:export PAI_DIR="$HOME/.claude",合并 settings.json.example 中的 hooks 配置,执行 mkdir -p ~/.claude/history/raw-outputs,并在 apps/server 与 apps/client 目录分别运行 bun install。启动时先启动服务端,再启动客户端,然后访问 http://localhost:5173。
数据以 JSONL 格式存储于 ~/.claude/history/raw-outputs/YYYY-MM/YYYY-MM-DD_all-events.jsonl,服务端在内存中保留最近 1000 条事件,通过 WebSocket 实时推送,无需数据库。架构为 Claude Code hooks 捕获事件写入 JSONL,服务端 file-ingest.ts 监听文件并流式传输到内存,Vue 3 客户端(Vite + Tail)进行可视化。
限制:依赖 Bun 运行时、已配置 hooks 的 Claude Code 与 PAI_DIR 环境变量;数据以本地文件加内存方式处理,历史顺序非完整数据库持久化方案;官方未提供收费、定价或平台支持信息。