Skip to main content
O CLI vem com um modo de saída mínimo e estruturado (--prompt-only) projetado para agentes de programação de IA analisarem e agirem. Combinado com uma chave de equipe, ele permite loops autônomos de revisão e correção — o agente revisa, aplica correções, reavalia e faz commit, tudo sem intervenção humana no caminho crítico.

​
Agentes Suportados

  • Claude Code — skill nativa via instalador de skills.
  • Cursor — skill nativa.
  • Codex — skill nativa, com Decision Memory via hooks notify.
  • Windsurf — via saída --prompt-only.
Para qualquer outro agente que possa executar comandos shell e analisar texto estruturado, kodus review --prompt-only funciona imediatamente.

​
Configuração Mais Rápida

Instale o CLI e todas as skills de agentes de uma só vez:
Isso:
  1. Instala o binário @kodus/cli globalmente.
  2. Configura a chave de equipe em ~/.kodus/config.json.
  3. Implanta as skills do Kodus em todos os agentes detectados (Claude Code, Cursor, Codex, Windsurf).
Sem logins individuais. Sem prompts interativos. Pronto para loops de agentes imediatamente.

​
O Loop de Revisão e Correção

1

Agente executa revisão

O CLI retorna problemas estruturados com caminhos de arquivos, números de linha, severidades e correções sugeridas — em um formato de texto compacto projetado para ser consumido por um LLM.
2

Agente aplica correções

O agente lê a saída, decide quais correções aplicar (ou aceita todas via --fix) e edita os arquivos adequadamente.
3

Agente reavalia

Com --fail-on error, o loop termina com código não-zero enquanto ainda houver problemas de nível error ou superior. O agente continua em loop; quando a revisão retorna limpa, o processo termina com código 0 e o agente prossegue.
4

Agente faz commit e push

Uma vez que a revisão esteja limpa, o agente faz commit e push. Opcionalmente, instale o hook pre-push (kodus hook install) como uma rede de segurança adicional para pushes manuais.

​
Autenticação por Chave de Equipe para Agentes

Chaves de equipe são fortemente recomendadas para agentes — sem cadastro individual, sem login interativo, rotação fácil, rastreamento por dispositivo.
Gere uma chave em app.kodus.io/organization/cli-keys e distribua o comando de instalação exibido lá para sua equipe.
Salve a chave quando ela for exibida — ela não será mostrada novamente.

​
Flags de Saída Importantes

​
Combinando com Decision Memory

Combine loops de agentes com Decision Memory para capturar o raciocínio por trás de cada turno do agente como arquivos estruturados no seu repositório. O loop trata o que mudou; a memória captura por que.

​
Exemplo: Loop Claude Code com Validação de Negócio

Com o instalador de skills, a skill Kodus do Claude Code sabe quando invocar cada um desses — sem necessidade de engenharia de prompt da sua parte.

​
Relacionados

Decision Memory

Persista decisões de agentes como arquivos estruturados no seu repositório.

Conceitos

Modos de revisão, modos de diff e flags de saída para agentes.

Referência de Comandos

Listagem completa de flags.

Solução de Problemas

Problemas no loop de agentes, problemas com hooks, timeouts.