AgentWorks: a plataforma de agentes de IA que perseguem metas

Para quem é

O posicionamento oficial do AgentWorks é o de uma plataforma source-available para agentes de IA orientados a metas: você define para o agente uma métrica-alvo e ele trabalha até atingi-la. Se você já usa CLIs de agentes de código como Claude Code, Codex, Cursor, Pi ou Muse, ele roda diretamente sobre essas CLIs existentes.

Ao mesmo tempo, é um servidor MCP: se você quer consultar metas, ler relatórios e iniciar execuções direto do chat no ChatGPT, no Claude (Desktop, Code, Cowork) ou em qualquer cliente MCP, é uma boa escolha.

Premissas a observar: o caminho de instalação documentado oficialmente cobre apenas o macOS (instala em /Applications, remove a flag de quarentena do macOS e instala o Go via Homebrew quando necessário); outros sistemas operacionais não são mencionados. Também não é um serviço gerenciado pronto para usar: na primeira abertura, você mesmo precisa escolher uma pasta de workspace local e definir um AUTH_SECRET.

Primeira experiência em 3 minutos

Premissas: uma máquina com macOS e um terminal; o script instala o Go via Homebrew quando necessário.

No terminal, execute o comando oficial de instalação de uma linha:

curl -fsSL https://raw.githubusercontent.com/manishiitg/coding-agent-loop/main/install.sh | bash

Antes de apertar Enter, entenda os efeitos colaterais: o script baixa a release mais recente, instala o AgentWorks.app em /Applications, instala a MCP bridge que o Claude Code e o Codex usam para acessar ferramentas (colocada em ~/go/bin), remove a flag de quarentena do macOS e, por fim, abre o aplicativo. É uma ação de instalação com escritas locais, não uma operação somente leitura; se você tem receio de scripts remotos, confira antes o conteúdo da URL no navegador.

Configuração da primeira abertura: siga as instruções do aplicativo para escolher uma pasta de workspace e definir um AUTH_SECRET. Ele serve para criptografar as provider keys; se o mesmo workspace for aberto em várias máquinas, cada uma precisa reutilizar o mesmo valor.

Uma primeira chamada de baixo risco: o script de instalação já preparou a MCP bridge para o Claude Code e o Codex. No Claude Code, peça para consultar metas (check goals) ou ler relatórios (read reports): essas são as capacidades de leitura descritas oficialmente e não disparam execuções. Sinal de sucesso: o Claude Code retorna o status das metas ou o conteúdo de um relatório. Os passos de integração de outros clientes MCP (como ChatGPT ou Claude Desktop) não aparecem na página oficial e não serão inventados aqui.

Casos de uso

Caso 1: acompanhar o progresso e ler relatórios pelo chat. Cenário: você já entregou ao AgentWorks uma meta que persegue uma métrica e quer saber como está indo na conversa do dia a dia. Como: em um cliente já conectado, peça em linguagem natural para consultar as metas e ler os relatórios (check goals, read reports). Resultado esperado: a documentação oficial diz explicitamente que dá para ver as metas e ler os relatórios a partir desse chat; os campos retornados não estão listados, vale o que aparecer na saída real.

Caso 2: iniciar uma execução pelo chat. Cenário: você conclui que uma meta precisa avançar imediatamente e quer iniciá-la sem sair da conversa atual. Como: peça ao AgentWorks para fazer start runs. Resultado esperado: a execução começa e é conduzida pelas CLIs de agentes de código que você já tem instaladas (Claude Code, Codex, Cursor, Pi, Muse). Atenção: não é uma consulta, é uma ação que trabalha de verdade; a execução segue até atingir a métrica. Antes de iniciar, confirme que a configuração da meta e do escopo está correta; os pontos de confirmação humana no nível da execução não estão documentados oficialmente.

Limites de uso

Natureza de leitura e escrita: as capacidades expostas via MCP incluem tanto leitura (consultar metas, ler relatórios) quanto execução (iniciar execuções). Iniciar uma execução faz o agente trabalhar até atingir a métrica-alvo, com efeitos colaterais reais; não há marcação oficial de quais ferramentas são somente leitura, então não presuma que todas são.

Credenciais e dados locais: a primeira abertura exige escolher uma pasta de workspace local; o AUTH_SECRET criptografa as provider keys, e o mesmo workspace precisa reutilizar o mesmo valor em cada máquina. Como as provider keys são configuradas, a página oficial não detalha.

Efeitos colaterais e pontos de confirmação: o script de instalação grava em /Applications e ~/go/bin, remove a flag de quarentena do macOS e abre o aplicativo; depois que a execução começa, o agente segue trabalhando, e nenhum mecanismo de confirmação passo a passo foi encontrado na documentação oficial.

Limites explícitos e incógnitas: o caminho de instalação só aparece descrito para o macOS; a plataforma é source-available (o próprio título do repositório se diz Open source) e os termos da licença valem o que o repositório disser; o suporte a outras plataformas, a lista completa de ferramentas MCP e seus parâmetros, as formas de hospedagem remota e os métodos de autenticação além do AUTH_SECRET não estão documentados — confira no repositório oficial antes de usar.