Command reference ยท Cursor CLI
agent worker help [command]
Shows help for the worker subcommands.
agent worker help [command] is a terminal subcommand โ called as cursor-agent worker help [command] in the shell, not a slash command. It shows help text for the agent worker subcommands start and debug; without an argument, it lists both, and with either of the two as an argument, it shows that subcommand's details along with its flags.
A worker is a self-hosted instance that establishes a persistent outgoing HTTPS connection to Cursor's cloud and executes terminal commands, file changes, and other tool calls there on your own infrastructure โ for example, for cloud agents or as a personal 'My Machines' machine. agent worker start registers and starts this connection, among other things with flags like --pool, --worker-dir, --label, or --idle-release-timeout. agent worker debug checks authentication, privacy routing, repo labels, and whether Cursor sees matching workers at all, ahead of time.
โ WHEN TO USE IT?
Look up the available flags for worker start, e.g. for pool configuration
cursor-agent worker help start
Check what worker debug actually controls before using it in production
cursor-agent worker help debug
โ WHEN NOT TO?
Quickly see only the options of the worker command you're currently typing
agent worker help command is a separate call.
Better: append -h or --help directly, e.g. cursor-agent worker start --help
You want to directly start or test a worker
agent worker help only shows help text but doesn't connect a worker to Cursor.
Better: run cursor-agent worker start or cursor-agent worker debug directly
SOURCES
- Cursor Docs โ CLI Reference: Parameters โ cursor.com
MORE COMMANDS ยท Cursor CLI