Claude Agent Monitor

Claude Code é poderoso. Claude Code com múltiplos agentes rodando em paralelo via tmux é um multiplicador de força. Mas também é uma caixa preta.

Rodando 3-4 agentes simultaneamente: um refatorando um módulo, outro escrevendo testes, um terceiro corrigindo bugs, não há visibilidade sobre o que realmente está acontecendo. Qual agente está trabalhando em qual task? Aquela mudança de arquivo veio do Sprint 4 ou do Sprint 5?

Ferramentas existentes não foram feitas para esse workflow. Nada conecta atividade de agentes IA a tasks de sprint. Então Pedro construiu.

CAM é o mission control para agentes Claude Code. Ele se conecta à atividade do Claude Code no nível de processo, captura eventos em tempo real via Server-Sent Events, e renderiza tudo em um dashboard com visualização 3D, tracking Kanban e observabilidade multi-agente.

A premissa é simples: se Claude Code toca em um arquivo, CAM sabe. Cada tool use, leitura, escrita, comandos bash, buscas, dispara um hook que transmite para o dashboard. O correlation engine então descobre a qual task aquela atividade pertence, automaticamente.

CAM é um monorepo pnpm com 5 pacotes: @claudecam/shared (tipos + Zod schemas), @claudecam/hook (10 tipos de hook), @claudecam/server (Express.js + SQLite WAL + SSE), @claudecam/cli (Commander.js) e @claudecam/dashboard (React 19 + Vite + Zustand).

O Correlation Engine (1.461 linhas + módulo de similaridade de 355 linhas) roda um pipeline hierárquico de 5 camadas: match exato por ID (1.0), similaridade de tags (0.85-0.95), análise de file path (0.7-0.85), distância Jaro-Winkler (0.6-0.8) e overlap de keywords (0.5-0.7).

Agent Map 3D: A feature assinatura do CAM. Construído com React Three Fiber, renderiza um ambiente 3D procedural onde cada agente ativo é um avatar robô: NEXBOT para o agente principal, GENKUB para subagentes.

Observabilidade Multi-Agente: Cada agente Claude Code roda como um processo separado com seu próprio session ID. CAM rastreia todos, seja usando Claude Code Teams ou dividindo trabalho entre panes do tmux.

Kanban Auto-Updating: Tasks fluem entre colunas automaticamente baseado na atividade dos agentes. O board é reflexo em tempo real do trabalho real.

Três Temas Visuais: Modern (limpo), Terminal (retro) e Pixel Art. Modelo Open Core: Modern é gratuito, outros são premium potencial.

Dogfooding revela tudo. CAM foi construído para monitorar os agentes que estavam construindo CAM. Esse loop recursivo expôs edge cases que nenhum planejamento detectaria. O correlation engine passou por duas reescritas completas.

Decisões de arquitetura acumulam. Agrupar por sessão parecia óbvio no início. Só no Sprint 6 ficou claro que projetos, identificados pelo working directory, são o princípio organizador natural.

3D não é decoração: é compreensão. Representação espacial de atividade de agentes comunica estado mais rápido que qualquer tabela ou log.

CAM é o primeiro projeto open-source de Pedro. É também uma das primeiras ferramentas de observabilidade em tempo real construídas especificamente para agentes de IA de código.

Nunca estudou programação. Todo o monorepo de 5 pacotes, o correlation engine, a visualização 3D, o pipeline SSE, tudo foi construído por orquestração de IA, sprint por sprint, ao longo de 11 ciclos.