Documentation / MCP et ACP
Kiro, Codex et Antigravity
Yuli à la fois client ACP et serveur MCP, pour travailler avec votre Kiro, votre Codex ou votre Antigravity au sein de l’IDE.
En plus de Claude Code, Yuli fonctionne avec Kiro, Codex et Antigravity, chacun avec votre propre compte. Pour eux, Yuli est un client ACP (Agent Client Protocol), comme d’autres IDE, et en même temps leur serveur MCP.
| Canal | Rôle |
|---|---|
| ACP | Yuli envoie vos demandes et reçoit en direct la réponse, le raisonnement, les autorisations et le plan. |
| MCP | L’agent utilise les outils yuli_* : build, tests, vérification, qualité, base de données, Web Studio… |
Chaque agent dispose de sa propre conversation, de sa mission et de sa fenêtre de modifications. Changer d’agent ne mélange jamais les états.
Choisir l’agent
Dans le sélecteur Avec qui travaillez-vous ? au-dessus du chat, groupe « Votre abonnement · votre compte » :
| Agent | Compte |
|---|---|
| Claude Code | Votre compte Claude (Pro, Max ou Console). Voir Claude Code. |
| Kiro | Votre AWS Builder ID, Google ou GitHub. |
| Codex | Votre compte ChatGPT. |
| Antigravity | Votre compte Google. |
Yuli ne télécharge ni ne redistribue jamais ces agents : il détecte celui que vous avez installé.
Kiro
| Étape | Détail |
|---|---|
| Installer | S’il manque, vous verrez « Installez Kiro CLI pour l’utiliser ici » avec le lien vers kiro.dev/cli et la commande officielle. Requiert la version 1.28.2 ou ultérieure. |
| Avertissement | « Avant de commencer avec Kiro » : Kiro utilise votre compte et vos crédits, et le code qu’il lit transite vers AWS selon vos conditions. |
| Se connecter | Se connecter ouvre kiro-cli login dans un terminal de Yuli. Pour les machines distantes, Utiliser un code d’appareil. |
| Règles | Dans .kiro/steering/yuli.md et des fichiers de procédures, ou avec la première demande si la configuration est hors du projet. |
Yuli lance Kiro avec kiro-cli acp et une authentification gérée par le CLI lui-même. Le jeton reste dans Kiro.
Codex
| Étape | Détail |
|---|---|
| Installer | npm install -g @openai/codex @agentclientprotocol/codex-acp. Yuli utilise l’adaptateur ACP officiel codex-acp ; s’il ne trouve que codex, il vous signale que l’adaptateur manque. |
| Avertissement | « Avant de commencer avec Codex ». |
| Se connecter | codex login dans un terminal de Yuli, ou avec un code d’appareil. |
| Règles | Dans un bloc géré de AGENTS.md, ou avec la première demande si la configuration est hors du projet. |
Antigravity
| Étape | Détail |
|---|---|
| Installer | Téléchargez le serveur ACP d’Antigravity publié par Google et décompressez-le dans ~/.antigravity/acp/. |
| Avertissement | « Avant de commencer avec Antigravity ». |
| Se connecter | Il n’y a pas de CLI de connexion : le serveur ouvre la page Google dans votre navigateur et la session s’ouvre d’elle-même. |
| Règles | Dans .agent/rules/yuli.md, ou avec la première demande si la configuration est hors du projet. |
Google indique que l’accès à Antigravity au moyen d’outils non officiels peut enfreindre ses conditions. Yuli le rappelle dans l’avertissement préalable. Consultez-les avant de l’utiliser.
Travailler avec un agent ACP
- Conversation au design de Yuli : la réponse pendant sa rédaction, le raisonnement repliable, les outils sous forme de chronologie, le plan, les fichiers modifiés et la vérification.
- Zone de saisie :
Enterenvoie,Shift+Enterajoute une ligne,@mentionne des fichiers et/affiche les commandes annoncées par l’agent. - File d’attente : si l’agent est en train de travailler, ce que vous envoyez est mis en file d’attente. Arrêter (ou
Esc) annule le tour. - Modèle, effort et mode : via les listes annoncées par l’agent lui-même.
- Historique : ouvrez une session précédente ou démarrez-en une nouvelle.
- Autorisations : chaque demande apparaît dans une carte Yuli avec exactement les options de l’agent. Yuli n’invente jamais d’option et ne répond jamais à votre place.
Critère de fin
Ces agents n’ont pas de hook capable de bloquer la clôture du tour ; Yuli l’applique donc côté client : si le tour a modifié du code et que la vérification ou la mesure n’est pas au vert, il envoie une brève relance automatique indiquant ce qui manque.
- Elle apparaît dans la conversation comme un message de Yuli.
- Elle est limitée (3 par défaut) et vous pouvez la désactiver avec Relances automatiques, car elle consomme vos crédits.
- Si la connexion avec l’agent est perdue, Yuli ne renvoie jamais rien de lui-même.
Les mêmes règles
Git, CI et DevOps uniquement si vous le demandez ; branches uniquement si vous les demandez ; secrets protégés ; structure et noms vérifiés ; hooks du projet. Les mêmes qu’avec Claude Code.
Autres agents : règles exportées uniquement
Gemini CLI, Cursor et GitHub Copilot ne s’exécutent pas dans Yuli. Vous pouvez en revanche leur fournir les mêmes règles de projet : dans le Centre de gouvernance, Agents → Contexte, exportez vers GEMINI.md, .cursor/rules/yuli.mdc et .github/copilot-instructions.md. Voir Gate et Centre de gouvernance.