agent worker

Comando padre para iniciar un worker privado en la nube que ejecuta agent runs en el propio entorno.

agent worker conecta el propio equipo con Cursor y hace que las tareas de cloud agent corran ahí en lugar de en el entorno cloud propio de Cursor (self-hosted). Incluye los subcomandos start y debug. El worker se configura mediante flags como --worker-dir, --name, --label o --labels-file, --pool o --pool-name y --idle-release-timeout.

✅ ¿CUÁNDO USARLO?

Aportar hardware o entorno propio para ejecuciones de cloud agent (privacidad, herramientas especiales)

agent worker start --name build-worker-1 --worker-dir ~/repos/myapp

Registrar varios workers como un pool del que se sirven los cloud agents

agent worker start --pool --pool-name ci-pool

⛔ ¿CUÁNDO MEJOR NO?

Solo hace falta una única ejecución local del agente

agent worker inicia un proceso permanente conectado a Cursor para los handoffs de cloud agent, no una ejecución puntual.

Mejor: Usar una sesión interactiva normal con agent o agent -p

La configuración o la conexión deben comprobarse antes del arranque real

agent worker start se conecta de inmediato; los problemas de auth, privacidad o routing solo se ven después.

Mejor: Ejecutar antes agent worker debug para ver diagnósticos previos (preflight)

FUENTES

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