Command reference ยท Cursor CLI
agent worker debug
Runs preflight diagnostics for the private worker (auth, privacy, routing).
agent worker debug is a terminal subcommand and is called directly in the shell. According to the reference, it runs preflight diagnostics for the private cloud worker and checks authentication, privacy settings, and routing before the worker even runs. With the --json flag, the command outputs the diagnostic report in a machine-readable format, for example for further processing in a script or for a bug report.
There is no slash command for the worker area; worker functionality is only accessible via terminal subcommands under agent worker, for example also agent worker start.
agent worker debug doesn't start the worker itself, it only checks the prerequisites for it. If the configuration is already known to work, for example after a previous successful run, you can skip the diagnostics and call agent worker start directly to connect the worker.
โ WHEN TO USE IT?
Find errors before the first start
Run agent worker debug --json before a new worker is meant to go into production
Narrow down a worker's connection problem
Run agent worker debug to check whether auth, privacy, or routing is the cause
โ WHEN NOT TO?
The worker needs to run in production right away
agent worker debug doesn't start the worker, it only checks the prerequisites.
Better: Use agent worker start directly, if the configuration is already known to work
SOURCES
- Cursor Docs โ CLI Reference: Parameters โ cursor.com