Cómo instalar y ejecutar Cursor CLI en Windows

Qué necesitas antes de instalar Cursor CLI

• Una cuenta de usuario de Windows que pueda ejecutar comandos de PowerShell
• Una cuenta de Cursor para el inicio de sesión interactivo, o CURSOR_API_KEY
• Una carpeta de proyecto a la que Cursor Agent pueda acceder
• CodeAgentSwarm si quieres la interfaz Chat ACP y supervisión de varios agentes

Instala Cursor Agent con el comando oficial de Windows

Abre PowerShell y ejecuta el instalador nativo de Cursor:

irm 'https://cursor.com/install?win32=true' | iex

Cierra y vuelve a abrir PowerShell si el instalador ha cambiado tu PATH. Después, comprueba el comando instalado:

cursor-agent --version
Get-Command cursor-agent

CodeAgentSwarm puede ejecutar el mismo instalador oficial cuando falta Cursor Agent. La app comprueba el archivo nativo cursor-agent.cmd antes de iniciar Chat.

Inicia sesión y comprueba la autenticación

cursor-agent login
cursor-agent status

El flujo de acceso conecta la CLI con tu cuenta de Cursor, que consume la suscripción o el uso asociado a esa cuenta. En un entorno no interactivo, proporciona CURSOR_API_KEY mediante tu proceso habitual de gestión de secretos.

Usa cursor-agent logout cuando necesites eliminar el inicio de sesión actual del equipo.

Evita el conflicto del comando agent con Grok

No uses agent como atajo para Cursor. Otra CLI instalada puede controlar ese comando, y Grok es un ejemplo conocido. Una respuesta correcta de agent --version no demuestra que Cursor esté instalado.

Get-Command cursor-agent
Get-Command agent -ErrorAction SilentlyContinue

# Inicia Cursor de forma explícita
cursor-agent

Inicia un Chat ACP de Cursor en CodeAgentSwarm

Selecciona Cursor Agent al crear un Chat. CodeAgentSwarm lanza cursor-agent acp mediante stdio, completa el saludo ACP y muestra el texto y las llamadas de herramientas en streaming dentro de la conversación.

Puedes usar Agent, Plan o Ask cuando la sesión exponga esos modos, elegir los modelos disponibles, responder a solicitudes de permisos y cancelar una respuesta activa. Los servidores MCP del proyecto y del usuario se leen desde .cursor/mcp.json.

Para ver todas las funciones, lee la guía ACP de Cursor Agent CLI. Para organizar varias sesiones de Windows, continúa con la guía del enjambre de Cursor Agent.

Resuelve problemas comunes de Cursor CLI en Windows

• Windows no reconoce cursor-agent: vuelve a abrir PowerShell después de instalar y ejecuta Get-Command cursor-agent. Si sigue sin aparecer, repite el instalador oficial.
• Se abre el agente equivocado: confirma que has escrito cursor-agent, no agent. Usa Get-Command para ver qué ejecutable resolvió Windows.
• Falla la autenticación: ejecuta cursor-agent status y después repite cursor-agent login o comprueba CURSOR_API_KEY.
• El Historial en Chat agota el tiempo de espera: ejecuta cursor-agent update. Las versiones ACP antiguas pueden no anunciar loadSession.
• Faltan herramientas MCP: comprueba el archivo .cursor/mcp.json del proyecto o del usuario y reinicia la sesión después de corregirlo.

La guía del historial de Cursor CLI explica por qué la reanudación es condicional. Los detalles sobre planes y uso están en precios y uso de Cursor CLI.