AI Monitor Agent

Skill e monitor local para Claude Code, Codex e Grok. A distribuição é feita como pacote Python: instala-se pelo PyPI e, em seguida, registra-se a skill nos assistentes disponíveis no usuário atual.

O monitor permanece ligado até stop, mas não inicia tarefas de IA por conta própria nem controla sessões reais dos modelos. Os conectores ainda precisam ser implementados.

Requisitos

• Python 3.11 ou superior.
• Acesso à Internet para baixar o pacote e suas dependências.

Instalação pelo PyPI

Quando o pacote estiver publicado:

python -m pip install ai-monitor-agent
ai-monitor-agent install

No Windows:

py -m pip install ai-monitor-agent
ai-monitor-agent install

Para uma instalação isolada, use pipx install ai-monitor-agent e depois ai-monitor-agent install.

Instalação local durante o desenvolvimento

Na raiz deste repositório, instale o pacote e suas dependências diretamente:

python -m pip install .
ai-monitor-agent install

No Windows:

py -m pip install .
ai-monitor-agent install

O comando install copia a skill para os diretórios pessoais do Claude Code (~/.claude/skills/ai-monitor-agent/) e dos assistentes compatíveis com o diretório padrão de skills (~/.agents/skills/ai-monitor-agent/). Reinicie o aplicativo de IA após a instalação se a skill não aparecer.

Utilização

Inicie o monitor dentro do repositório que deseja acompanhar:

ai-monitor-agent start

Ou invoque a skill no assistente:

• Claude Code: /ai-monitor-agent
• Codex: $ai-monitor-agent
• Grok: /ai-monitor-agent

Para verificar ou encerrar:

ai-monitor-agent status
ai-monitor-agent stop

A página é criada em <raiz-do-repositório>/agents-monitor/index.html; a raiz é identificada pelo Git. Fora de um repositório Git, é usado o diretório atual. O servidor tenta usar a porta 6999 e escolhe outra porta livre se necessário. A CLI imprime a URL efetiva do painel e da API. O painel atualiza os dados a cada cinco segundos e também recebe eventos via WebSocket.

O runtime, o banco de dados e os logs ficam em ~/.ai-agent-factory/.

Desenvolvimento e publicação

Execute os testes:

python -m unittest discover -s test

Para construir o pacote localmente, use python -m pip install build e python -m build. A publicação no PyPI requer uma conta PyPI e deve ser feita por um mantenedor autorizado. O pacote ainda não foi publicado.

API

• GET /health — estado do serviço
• POST /api/v1/agents, GET /api/v1/agents — registar/listar agentes
• POST /api/v1/tasks, GET /api/v1/tasks — criar/listar tarefas
• POST /api/v1/events, GET /api/v1/events — publicar/listar eventos
• POST /api/v1/commands — enfileirar comando
• GET /api/v1/commands/pending/{agent_id} — consultar comandos
• POST /api/v1/commands/{command_id}/ack — confirmar comando
• WS /ws — atualizações em tempo real

Segurança e limitações

O serviço escuta apenas em 127.0.0.1 e não tem autenticação. Não o exponha à Internet ou a redes não confiáveis. Os comandos enviados pela API são apenas enfileirados; um conector compatível precisaria buscá-los e executá-los. A skill não coleta prompts e o monitor não fica executando chamadas aos modelos em segundo plano.