agent acp

Démarre la CLI en mode serveur ACP (Agent Client Protocol) pour les intégrations éditeur et client.

agent acp démarre Cursor Agent comme serveur ACP via stdio, avec des messages JSON-RPC 2.0 délimités par des retours à la ligne, par ex. pour des intégrations éditeur comme Zed ou JetBrains. Selon la doc, la commande est 'hidden' et destinée à la construction de clients personnalisés, pas à une utilisation normale du terminal. L'authentification se fait au préalable via agent login, --api-key/CURSOR_API_KEY ou --auth-token/CURSOR_AUTH_TOKEN ; les options d'endpoint et TLS (-e, -k) sont ajoutées avant acp, par ex. agent -e https://api2.cursor.sh acp.

✅ QUAND L’UTILISER ?

Construire son propre client ou une intégration éditeur avec Cursor Agent

agent acp — puis envoyer initialize/session/new/session/prompt via JSON-RPC sur stdin/stdout

S'authentifier au préalable avec une clé API plutôt que de se connecter via le flux ACP

agent --api-key "$CURSOR_API_KEY" acp

⛔ QUAND ÉVITER ?

Utilisation normale du terminal sans construire de client

agent acp ne renvoie que des messages JSON-RPC bruts sur stdout, pas une interface de chat lisible

Mieux: utiliser simplement agent (mode interactif) ou agent -p pour des scripts

Des outils/données externes doivent être mis à disposition de l'agent

ACP est destiné aux intégrations client, pas au branchement d'outils sur l'agent

Mieux: utiliser agent mcp pour connecter des serveurs MCP et donner accès à des tools

SOURCES

Cursor Docs — CLI Reference: Parameters ↗ cursor.com
Cursor Docs — CLI ACP ↗ cursor.com