Metadata-Version: 2.4
Name: ai-monitor-agent
Version: 0.2.0
Summary: Install and run the AI Monitor Agent skill and local dashboard.
License-Expression: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: fastapi<1,>=0.115
Requires-Dist: uvicorn[standard]<1,>=0.30
Requires-Dist: pydantic<3,>=2.8
Dynamic: license-file

# 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:

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

No Windows:

```powershell
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:

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

No Windows:

```powershell
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:

```bash
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:

```bash
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:

```bash
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.
