Documentación / MCP y ACP

Kiro, Codex y Antigravity

Yuli como cliente ACP y servidor MCP a la vez, para trabajar con tu Kiro, tu Codex o tu Antigravity dentro del IDE.

Además de Claude Code, Yuli trabaja con Kiro, Codex y Antigravity, cada uno con tu propia cuenta. Para ellos, Yuli es un cliente ACP (Agent Client Protocol), igual que otros IDE, y a la vez su servidor MCP.

Canal Para qué
ACP Yuli envía tus pedidos y recibe la respuesta en vivo, el razonamiento, los permisos y el plan.
MCP El agente usa las herramientas yuli_*: build, pruebas, verificación, calidad, base de datos, Web Studio…

Cada agente tiene su propia conversación, misión y ventana de cambios. Cambiar de agente nunca mezcla estados.

Elegir el agente

En el selector ¿Con quién trabajas? de arriba del chat, grupo «Tu suscripción · tu cuenta»:

Agente Cuenta
Claude Code Tu cuenta de Claude (Pro, Max o Console). Ver Claude Code.
Kiro Tu AWS Builder ID, Google o GitHub.
Codex Tu cuenta de ChatGPT.
Antigravity Tu cuenta de Google.

Yuli nunca descarga ni redistribuye estos agentes: detecta el que instalaste.

Kiro

Paso Detalle
Instalar Si falta, verás «Instala Kiro CLI para usarlo aquí» con el enlace a kiro.dev/cli y el comando oficial. Requiere la versión 1.28.2 o posterior.
Aviso «Antes de empezar con Kiro»: Kiro usa tu cuenta y tus créditos, y el código que lee viaja a AWS bajo tus términos.
Iniciar sesión Iniciar sesión abre kiro-cli login en una terminal de Yuli. Para máquinas remotas, Usar un código de dispositivo.
Reglas En .kiro/steering/yuli.md y archivos de procedimientos, o con el primer pedido si la configuración está fuera del proyecto.

Yuli arranca Kiro con kiro-cli acp y autenticación por el propio CLI. El token se queda en Kiro.

Codex

Paso Detalle
Instalar npm install -g @openai/codex @agentclientprotocol/codex-acp. Yuli usa el adaptador ACP oficial codex-acp; si solo encuentra codex, te avisa que falta el adaptador.
Aviso «Antes de empezar con Codex».
Iniciar sesión codex login en una terminal de Yuli, o con código de dispositivo.
Reglas En un bloque gestionado de AGENTS.md, o con el primer pedido si la configuración está fuera del proyecto.

Antigravity

Paso Detalle
Instalar Descarga el servidor ACP de Antigravity que publica Google y descomprímelo en ~/.antigravity/acp/.
Aviso «Antes de empezar con Antigravity».
Iniciar sesión No hay CLI de login: el servidor abre la página de Google en tu navegador y la sesión se abre sola.
Reglas En .agent/rules/yuli.md, o con el primer pedido si la configuración está fuera del proyecto.

Google indica que el acceso a Antigravity con herramientas no oficiales puede incumplir sus términos. Yuli lo muestra en el aviso previo. Revísalos antes de usarlo.

Trabajar con un agente ACP

  • Conversación con el diseño de Yuli: la respuesta mientras se escribe, el razonamiento plegable, las herramientas como línea de tiempo, el plan, los archivos cambiados y la verificación.
  • Cuadro de texto: Enter envía, Shift+Enter agrega una línea, @ menciona archivos y / muestra los comandos que anuncia el agente.
  • Cola: si el agente está trabajando, lo que envíes queda en cola. Detener (o Esc) cancela el turno.
  • Modelo, esfuerzo y modo: con las listas que anuncia el propio agente.
  • Historial: abre una sesión anterior o empieza una nueva.
  • Permisos: cada petición aparece en una tarjeta de Yuli con exactamente las opciones del agente. Yuli nunca inventa una opción ni responde por ti.

Criterio de terminado

Estos agentes no tienen un hook que bloquee el cierre del turno, así que Yuli lo aplica como cliente: si el turno cambió código y la verificación o la medición no están en verde, envía un seguimiento automático breve con lo que falta.

  • Se ve en la conversación como mensaje de Yuli.
  • Tiene un límite (3 por defecto) y lo puedes desactivar con Seguimientos automáticos, porque usa tus créditos.
  • Si la conexión con el agente se cae, Yuli nunca reenvía nada por su cuenta.

Las mismas reglas

Git, CI y DevOps solo si lo pides; ramas solo si las pides; secretos protegidos; estructura y nombres revisados; hooks del proyecto. Las mismas que con Claude Code.

Otros agentes: solo reglas exportadas

Gemini CLI, Cursor y GitHub Copilot no se ejecutan dentro de Yuli. Lo que sí puedes hacer es darles las mismas reglas del proyecto: en el Centro de Gobierno, Agentes → Contexto, exporta a GEMINI.md, .cursor/rules/yuli.mdc y .github/copilot-instructions.md. Ver Gate y Centro de Gobierno.