Guía de Cursor CLI: instalación, modo Agent y ACP
Por CodeAgentSwarm Team · Actualizado el 16 de agosto de 2026
cursor-agent. CodeAgentSwarm no usa el alias genérico agent porque otra CLI instalada puede ser su propietaria. Cursor IDE y Cursor Agent CLI pertenecen al mismo producto, pero son interfaces distintas: el IDE es el editor y cursor-agent funciona desde un terminal o un cliente ACP.Qué hace la integración de Cursor por ACP
CodeAgentSwarm inicia cursor-agent acp por stdio y habla JSON-RPC. Cursor sigue siendo el proveedor de modelos y herramientas. La app presenta cada turno, llamada de herramienta y decisión en el mismo espacio que Claude Code, Codex CLI, OpenCode, Kimi Code, Antigravity CLI y Grok Build.
- Muestra texto y herramientas en streaming mientras Cursor trabaja
- Permite aprobar o rechazar comandos sin bloquear la sesión
- Cancela una respuesta activa
- Expone los modos Agent, Plan y Ask de Cursor
- Permite elegir los modelos de la sesión activa
- Acepta imágenes cuando la versión instalada anuncia esa capacidad
Instalar y autenticar Cursor Agent CLI
CodeAgentSwarm detecta cursor-agent de forma explícita y puede ejecutar el instalador oficial de Cursor para macOS, Linux o Windows nativo cuando falta la CLI.
# macOS o Linux
curl https://cursor.com/install -fsS | bash
# PowerShell en Windows nativo
irm 'https://cursor.com/install?win32=true' | iex
cursor-agent --version
cursor-agent login
cursor-agent statusPara CI u otro entorno no interactivo, Cursor también admite CURSOR_API_KEY. En el escritorio, el login del navegador usa tu cuenta de Cursor y su suscripción o consumo.
En Windows, CodeAgentSwarm descarga el instalador PowerShell oficial de Cursor y verifica el cursor-agent.cmd nativo antes de iniciar Chat. Nunca usa como alternativa un comando agent genérico.
Usar los modos Agent, Plan y Ask
Elige la interacción antes de enviar el prompt. Agent puede inspeccionar y modificar el proyecto, Plan prepara el enfoque de implementación antes de editar y Ask es la opción de solo lectura para explicaciones e investigación. CodeAgentSwarm conserva la selección al reabrir el Chat o pasar una sesión de la vista terminal a Chat.
El mismo Chat muestra los modelos de Cursor y permite adjuntar imágenes cuando la versión conectada anuncia esas capacidades ACP. Las respuestas, herramientas y solicitudes de permiso aparecen mientras ocurren, y Detener cancela el turno activo.
MCP, reglas, skills y extensiones de Cursor
CodeAgentSwarm lee los servidores MCP de usuario y proyecto desde .cursor/mcp.json sin modificar ninguno de los archivos. Las entradas del proyecto prevalecen sobre las de usuario con el mismo nombre, y los servidores combinados se envían mediante el campo nativo mcpServers de ACP. Las reglas y skills siguen perteneciendo a Cursor.
El adaptador ACP también entiende las solicitudes específicas de Cursor para preguntas, planes, todos, tareas delegadas e imágenes generadas. Se convierten en elementos nativos de la conversación en vez de aparecer como JSON sin procesar.
La instalación, los modos, MCP y Skills pertenecen a esta guía. Para flujos concretos, sigue con el historial de Cursor CLI, el enjambre de Cursor Agent o la guía de Cursor CLI en Windows.
Historial y compatibilidad entre versiones
Las versiones de Cursor difieren en su soporte de reanudación por ACP. CodeAgentSwarm habilita session/load solo cuando el handshake informa agentCapabilities.loadSession: true. Así no muestra un botón de reanudar que nunca podría funcionar.
cursor-agent update
# cursor-agent upgrade también funcionaUna versión antigua de Cursor CLI aún puede iniciar un Chat nuevo. CodeAgentSwarm muestra cómo actualizar y no guarda ese Chat como reanudable hasta que la capacidad esté disponible.
La guía de historial y reanudación explica qué cambia cuando una versión ACP antigua informa loadSession: false.
Ejecutar Cursor Agent junto a otros agentes
Crea un Chat de Cursor para una tarea e inicia Codex, Claude Code u otra CLI compatible para la siguiente. Cada agente tiene su propia sesión y contexto de proyecto, mientras CodeAgentSwarm mantiene visibles el estado, permisos, avance de tareas e historial.
Es útil cuando quieres los modelos y reglas de proyecto de Cursor sin mover cada tarea al editor, o cuando un flujo con varios agentes necesita una superficie común de supervisión.
Consulta la guía del enjambre de Cursor Agent para patrones de aislamiento y reparto de tareas, o compara el flujo en Cursor CLI vs Claude Code.
Preguntas frecuentes
Sí. Inicia el binario oficial cursor-agent en modo ACP mediante stdio y JSON-RPC.
Sí. Inicia sesión con cursor-agent login o usa CURSOR_API_KEY. La autenticación y el consumo siguen perteneciendo a Cursor.
Sí. CodeAgentSwarm lee los archivos .cursor/mcp.json de usuario y proyecto sin modificarlos y envía los servidores combinados mediante ACP.
Solo cuando la versión instalada de Cursor CLI anuncia soporte ACP para loadSession. Las versiones antiguas pueden iniciar chats nuevos, pero muestran una instrucción de actualización en vez de una acción rota.
Sí. CodeAgentSwarm puede instalar y ejecutar Cursor Agent de forma nativa en Windows con el instalador PowerShell oficial de Cursor.
Ejecuta Cursor Agent junto al resto de tus agentes con Chat en streaming, permisos visibles, historial por proyecto y un solo sitio para supervisarlo todo.