agent acp

Inicia la CLI en modo servidor ACP (Agent Client Protocol) para integraciones con editores y clientes.

agent acp inicia Cursor Agent como servidor ACP sobre stdio, con mensajes JSON-RPC 2.0 delimitados por saltos de línea, p. ej. para integraciones con editores como Zed o JetBrains. Según la documentación, el comando está 'oculto' y pensado para construir clientes propios, no para uso normal en terminal. La autenticación se hace antes mediante agent login, --api-key/CURSOR_API_KEY o --auth-token/CURSOR_AUTH_TOKEN; las opciones de endpoint y TLS (-e, -k) se añaden antes de acp, p. ej. agent -e https://api2.cursor.sh acp.

✅ ¿CUÁNDO USARLO?

Construir un cliente propio o una integración de editor contra Cursor Agent

agent acp — y luego enviar initialize/session/new/session/prompt por JSON-RPC vía stdin/stdout

Autenticarse de antemano con una API key, en lugar de iniciar sesión dentro del flujo ACP

agent --api-key "$CURSOR_API_KEY" acp

⛔ ¿CUÁNDO MEJOR NO?

Uso normal de terminal sin cliente propio

agent acp solo da mensajes JSON-RPC en bruto por stdout, no una interfaz de chat legible.

Mejor: Usar simplemente agent (modo interactivo) o agent -p para scripts

Se quieren poner tools o datos externos a disposición del agente

ACP está pensado para integraciones de cliente, no para conectar tools al agente.

Mejor: Usar agent mcp para integrar servidores MCP y dar acceso a tools

FUENTES

Documentación de Cursor — CLI Reference: Parameters ↗ cursor.com
Documentación de Cursor — CLI ACP ↗ cursor.com