Documentação / MCP e ACP
Kiro, Codex e Antigravity
O Yuli como cliente ACP e servidor MCP ao mesmo tempo, para trabalhar com o seu Kiro, o seu Codex ou o seu Antigravity dentro do IDE.
Além do Claude Code, o Yuli trabalha com Kiro, Codex e Antigravity, cada um com a sua própria conta. Para eles, o Yuli é um cliente ACP (Agent Client Protocol), como outros IDEs, e ao mesmo tempo o seu servidor MCP.
| Canal | Para quê |
|---|---|
| ACP | O Yuli envia os seus pedidos e recebe ao vivo a resposta, o raciocínio, as permissões e o plano. |
| MCP | O agente usa as ferramentas yuli_*: build, testes, verificação, qualidade, banco de dados, Web Studio… |
Cada agente tem a sua própria conversa, missão e janela de alterações. Trocar de agente nunca mistura estados.
Escolher o agente
No seletor Com quem você trabalha? acima do chat, grupo “Sua assinatura · sua conta”:
| Agente | Conta |
|---|---|
| Claude Code | A sua conta Claude (Pro, Max ou Console). Veja Claude Code. |
| Kiro | O seu AWS Builder ID, Google ou GitHub. |
| Codex | A sua conta do ChatGPT. |
| Antigravity | A sua conta Google. |
O Yuli nunca baixa nem redistribui esses agentes: ele detecta o que você instalou.
Kiro
| Passo | Detalhe |
|---|---|
| Instalar | Se estiver faltando, você verá “Instale o Kiro CLI para usá-lo aqui” com o link para kiro.dev/cli e o comando oficial. Requer a versão 1.28.2 ou posterior. |
| Aviso | “Antes de começar com o Kiro”: o Kiro usa a sua conta e os seus créditos, e o código que ele lê vai para a AWS sob os seus termos. |
| Entrar | Entrar abre kiro-cli login em um terminal do Yuli. Para máquinas remotas, Usar um código de dispositivo. |
| Regras | Em .kiro/steering/yuli.md e arquivos de procedimentos, ou com o primeiro pedido se a configuração estiver fora do projeto. |
O Yuli inicia o Kiro com kiro-cli acp e autenticação pelo próprio CLI. O token fica no Kiro.
Codex
| Passo | Detalhe |
|---|---|
| Instalar | npm install -g @openai/codex @agentclientprotocol/codex-acp. O Yuli usa o adaptador ACP oficial codex-acp; se encontrar apenas codex, ele avisa que falta o adaptador. |
| Aviso | “Antes de começar com o Codex”. |
| Entrar | codex login em um terminal do Yuli, ou com código de dispositivo. |
| Regras | Em um bloco gerenciado de AGENTS.md, ou com o primeiro pedido se a configuração estiver fora do projeto. |
Antigravity
| Passo | Detalhe |
|---|---|
| Instalar | Baixe o servidor ACP do Antigravity publicado pelo Google e descompacte-o em ~/.antigravity/acp/. |
| Aviso | “Antes de começar com o Antigravity”. |
| Entrar | Não há CLI de login: o servidor abre a página do Google no seu navegador e a sessão é aberta automaticamente. |
| Regras | Em .agent/rules/yuli.md, ou com o primeiro pedido se a configuração estiver fora do projeto. |
O Google informa que o acesso ao Antigravity com ferramentas não oficiais pode violar os seus termos. O Yuli mostra isso no aviso prévio. Revise-os antes de usá-lo.
Trabalhar com um agente ACP
- Conversa com o design do Yuli: a resposta enquanto é escrita, o raciocínio recolhível, as ferramentas como linha do tempo, o plano, os arquivos alterados e a verificação.
- Caixa de texto:
Enterenvia,Shift+Enteradiciona uma linha,@menciona arquivos e/mostra os comandos que o agente anuncia. - Fila: se o agente estiver trabalhando, o que você enviar fica na fila. Parar (ou
Esc) cancela o turno. - Modelo, esforço e modo: com as listas que o próprio agente anuncia.
- Histórico: abre uma sessão anterior ou começa uma nova.
- Permissões: cada solicitação aparece em um cartão do Yuli com exatamente as opções do agente. O Yuli nunca inventa uma opção nem responde por você.
Critério de concluído
Esses agentes não têm um hook que bloqueie o encerramento do turno, então o Yuli o aplica como cliente: se o turno alterou código e a verificação ou a medição não estão verdes, ele envia um breve acompanhamento automático com o que falta.
- Aparece na conversa como mensagem do Yuli.
- Tem um limite (3 por padrão) e você pode desativá-lo em Acompanhamentos automáticos, porque ele usa os seus créditos.
- Se a conexão com o agente cair, o Yuli nunca reenvia nada por conta própria.
As mesmas regras
Git, CI e DevOps só se você pedir; branches só se você pedir; segredos protegidos; estrutura e nomes revisados; hooks do projeto. As mesmas do Claude Code.
Outros agentes: só regras exportadas
Gemini CLI, Cursor e GitHub Copilot não são executados dentro do Yuli. O que você pode fazer é dar a eles as mesmas regras do projeto: na Central de Governança, Agentes → Contexto, exporte para GEMINI.md, .cursor/rules/yuli.mdc e .github/copilot-instructions.md. Veja Gate e Central de Governança.