Documentație / MCP și ACP
Kiro, Codex și Antigravity
Yuli este în același timp client ACP și server MCP, ca să lucrezi cu propriul Kiro, Codex sau Antigravity în IDE.
Pe lângă Claude Code, Yuli lucrează cu Kiro, Codex și Antigravity, fiecare cu propriul tău cont. Pentru ei, Yuli este un client ACP (Agent Client Protocol), la fel ca alte IDE-uri, și în același timp serverul lor MCP.
| Canal | La ce servește |
|---|---|
| ACP | Yuli trimite cererile tale și primește în timp real răspunsul, raționamentul, permisiunile și planul. |
| MCP | Agentul folosește uneltele yuli_*: build, teste, verificare, calitate, bază de date, Web Studio… |
Fiecare agent are propria conversație, misiune și fereastră de modificări. Schimbarea agentului nu amestecă niciodată stările.
Alegerea agentului
În selectorul Cu cine lucrezi? de deasupra chatului, grupul „Abonamentul tău · contul tău”:
| Agent | Cont |
|---|---|
| Claude Code | Contul tău Claude (Pro, Max sau Console). Vezi Claude Code. |
| Kiro | AWS Builder ID, Google sau GitHub. |
| Codex | Contul tău ChatGPT. |
| Antigravity | Contul tău Google. |
Yuli nu descarcă și nu redistribuie niciodată acești agenți: îl detectează pe cel pe care l-ai instalat.
Kiro
| Pas | Detaliu |
|---|---|
| Instalare | Dacă lipsește, vei vedea „Instalează Kiro CLI ca să-l folosești aici” cu linkul către kiro.dev/cli și comanda oficială. Necesită versiunea 1.28.2 sau mai nouă. |
| Avertisment | „Înainte să începi cu Kiro”: Kiro folosește contul și creditele tale, iar codul pe care îl citește ajunge la AWS, în condițiile tale. |
| Autentificare | Autentifică-te deschide kiro-cli login într-un terminal Yuli. Pentru mașini la distanță, Folosește un cod de dispozitiv. |
| Reguli | În .kiro/steering/yuli.md și în fișierele de proceduri, sau odată cu prima cerere dacă configurația este în afara proiectului. |
Yuli pornește Kiro cu kiro-cli acp și cu autentificare prin propriul CLI. Tokenul rămâne în Kiro.
Codex
| Pas | Detaliu |
|---|---|
| Instalare | npm install -g @openai/codex @agentclientprotocol/codex-acp. Yuli folosește adaptorul ACP oficial codex-acp; dacă găsește doar codex, te anunță că lipsește adaptorul. |
| Avertisment | „Înainte de a începe cu Codex”. |
| Autentificare | codex login într-un terminal Yuli sau cu cod de dispozitiv. |
| Reguli | Într-un bloc gestionat din AGENTS.md, sau odată cu prima cerere dacă configurația este în afara proiectului. |
Antigravity
| Pas | Detaliu |
|---|---|
| Instalare | Descarcă serverul ACP al Antigravity publicat de Google și dezarhivează-l în ~/.antigravity/acp/. |
| Avertisment | „Înainte de a începe cu Antigravity”. |
| Autentificare | Nu există CLI de autentificare: serverul deschide pagina Google în browserul tău, iar sesiunea se deschide singură. |
| Reguli | În .agent/rules/yuli.md, sau odată cu prima cerere dacă configurația este în afara proiectului. |
Google precizează că accesarea Antigravity cu unelte neoficiale poate încălca termenii săi. Yuli afișează acest lucru în avertismentul prealabil. Consultă-i înainte de utilizare.
Lucrul cu un agent ACP
- Conversație cu designul Yuli: răspunsul pe măsură ce este scris, raționamentul pliabil, uneltele sub formă de cronologie, planul, fișierele modificate și verificarea.
- Caseta de text:
Entertrimite,Shift+Enteradaugă o linie,@menționează fișiere, iar/afișează comenzile anunțate de agent. - Coadă: dacă agentul lucrează, ce trimiți rămâne în coadă. Oprește (sau
Esc) anulează tura. - Model, efort și mod: cu listele anunțate de agentul însuși.
- Istoric: deschide o sesiune anterioară sau începe una nouă.
- Permisiuni: fiecare cerere apare într-un card Yuli cu exact opțiunile agentului. Yuli nu inventează niciodată o opțiune și nu răspunde în locul tău.
Criteriul de finalizare
Acești agenți nu au un hook care să blocheze încheierea turei, așa că Yuli îl aplică în calitate de client: dacă tura a modificat cod, iar verificarea sau măsurarea nu sunt în verde, trimite o scurtă revenire automată cu ce mai lipsește.
- Apare în conversație ca mesaj Yuli.
- Are o limită (implicit 3) și o poți dezactiva cu Reveniri automate, pentru că folosește creditele tale.
- Dacă legătura cu agentul cade, Yuli nu retrimite niciodată nimic din proprie inițiativă.
Aceleași reguli
Git, CI și DevOps doar dacă le ceri; ramuri doar dacă le ceri; secrete protejate; structură și nume verificate; hook-urile proiectului. Aceleași ca la Claude Code.
Alți agenți: doar reguli exportate
Gemini CLI, Cursor și GitHub Copilot nu rulează în Yuli. Ce poți face însă este să le dai aceleași reguli ale proiectului: în Centrul de guvernanță, Agenți → Context, exportă în GEMINI.md, .cursor/rules/yuli.mdc și .github/copilot-instructions.md. Vezi Gate și Centrul de guvernanță.