agent worker debug

Runs preflight diagnostics for the private worker (auth, privacy, routing).

agent worker debug checks the private worker's authentication, privacy settings, and routing before actually starting it, and prints a diagnostic report. --json outputs the report as machine-readable JSON.

✅ WHEN TO USE IT?

Catch configuration mistakes before the first production start of a new worker

agent worker debug --json

⛔ WHEN NOT TO?

The worker should just run in production directly, without a prior check

agent worker debug doesn't start the worker, it only checks the prerequisites.

Better: Use agent worker start directly once the configuration is already known to work

SOURCES

Cursor Docs — CLI Reference: Parameters ↗ cursor.com