Referencia de comandos · Cursor CLI
agent worker debug
Ejecuta diagnósticos previos (preflight) del worker privado (auth, privacidad, routing).
agent worker debug es un subcomando de terminal y se invoca directamente en la shell. Según la referencia, ejecuta diagnósticos preflight para el worker en la nube privada y comprueba la autenticación, la configuración de privacidad y el enrutamiento antes de que el worker llegue a ejecutarse. Con el flag --json, el comando devuelve el informe de diagnóstico en formato legible por máquina, por ejemplo para procesarlo en un script o incluirlo en un informe de error.
No existe un comando de barra para el área de workers; la funcionalidad de worker solo es accesible mediante subcomandos de terminal bajo agent worker, como también agent worker start.
agent worker debug no inicia el worker en sí, solo comprueba los requisitos previos para ello. Si la configuración ya se sabe que funciona, por ejemplo tras una ejecución previa exitosa, puedes saltarte el diagnóstico e invocar directamente agent worker start para conectar el worker.
✅ ¿CUÁNDO USARLO?
Detectar errores antes del primer inicio
Ejecuta agent worker debug --json antes de que un worker nuevo pase a producción
Acotar un problema de conexión de un worker
Ejecuta agent worker debug para comprobar si la causa es la autenticación, la privacidad o el enrutamiento
⛔ ¿CUÁNDO MEJOR NO?
El worker debe funcionar en producción de inmediato
agent worker debug no inicia el worker, solo comprueba los requisitos previos.
Mejor: Usa directamente agent worker start si la configuración ya se sabe que funciona
FUENTES
- Documentación de Cursor — CLI Reference: Parameters ↗ cursor.com