agent worker start

Inicia el worker privado en la nube y lo conecta con Cursor.

agent worker start inicia el proceso de worker privado y lo conecta con Cursor, de modo que las tareas de cloud agent corran en el propio entorno en lugar de en la nube de Cursor. Se configura mediante flags como --worker-dir (raíz del workspace, repetible; el primer valor determina la identidad de asignación), --name, --label/--labels-file, --pool/--pool-name, --idle-release-timeout y --management-addr para /healthz, /readyz, /metrics. --verbose activa logs de arranque detallados.

✅ ¿CUÁNDO USARLO?

Poner a disposición varios repos a la vez como workspace del worker

agent worker start --worker-dir ~/repos/app-a --worker-dir ~/repos/app-b

Exponer endpoints de health y metrics para monitorizar el worker

agent worker start --management-addr 0.0.0.0:9100

⛔ ¿CUÁNDO MEJOR NO?

Comprobar de antemano si la auth y la red llegarían a funcionar

agent worker start se conecta de inmediato en producción, sin hacer antes solo una prueba.

Mejor: Ejecutar antes agent worker debug, y después agent worker start

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

agent worker start inicia un proceso permanente conectado a Cursor.

Mejor: Usar una sesión normal con agent o agent -p en lugar de operar un worker

FUENTES

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