`agent acp (Agent Client Protocol)` în Cursor IDE

Cursor CLI (agent) Cursor CLI (2026)

agent acp pornește Cursor CLI ca server ACP pe stdio, cu mesaje JSON-RPC 2.0, pentru clienți și integrări proprii.

Sintaxă & invocare

agent acp

Ce face `agent acp (Agent Client Protocol)`

agent acp rulează CLI-ul ca server ACP (Agent Client Protocol). Clientul scrie cereri și notificări pe stdin, CLI-ul răspunde pe stdout, iar logurile pot apărea pe stderr. Mesajele sunt JSON-RPC 2.0, câte unul pe rând.

O sesiune tipică trece prin initialize, authenticate cu methodId: "cursor_login", session/new (sau session/load) și session/prompt; clientul tratează notificările session/update, răspunde la session/request_permission și poate trimite session/cancel. Te poți autentifica dinainte cu agent login sau cu --api-key.

Comanda este ascunsă din ajutorul implicit. Pentru lucrul obișnuit în terminal, documentația recomandă agent interactiv.

Sintaxă și opțiuni

Opțiune / Parametru	Descriere
`stdin`	Cererile și notificările clientului.
`stdout`	Răspunsurile și notificările CLI-ului.
`stderr`	Loguri.

Exemple practice

Exemplul 1: Pornirea serverului ACP

agent acp

Exemplul 2: Cu cheie API

agent --api-key "$CURSOR_API_KEY" acp

Greșeli frecvente și bune practici

Citești stderr ca pe un canal de răspunsuri. Răspunsurile vin doar pe stdout.
Folosești agent acp pentru lucru interactiv. Este gândit pentru clienți proprii.

Ce face agent acp (Agent Client Protocol)