Cursor CLI commands and subcommands

Starts in agent mode, the default. When no command is specified, Cursor Agent starts in interactive agent mode; an initial prompt can be passed as an argument.

prompt: initial prompt for the agent

Authenticates with Cursor using a browser flow and stores credentials locally. During login, pressing q reveals a QR code for the same login URL.

Signs out and clears stored authentication.

Views authentication status: whether you are authenticated, account information, and current endpoint configuration.

--format text|json

Displays version, system, and account info.

--format text|json

Lists available models for this account, including team Bedrock models and respecting team model restrictions.

Manages MCP servers configured for Cursor Agent. MCP in the CLI uses the same configuration as the editor.

login | list | list-tools | enable | disable

Authenticates with an MCP server configured in .cursor/mcp.json or ~/.cursor/mcp.json, with automatic callback handling.

identifier

Lists configured MCP servers and their status in an interactive menu showing names, connection status, configuration source, and transport.

Lists available tools and their argument names for a specific MCP server.

identifier

Adds an MCP server to the local approved list.

identifier

Disables an MCP server so it will not load or prompt for approval.

identifier

Configures sandbox mode or runs one command in a sandbox. Hidden command.

enable | disable | reset | run | help

Enables sandbox mode for command execution.

Disables sandbox mode and uses allowlist mode.

Resets sandbox configuration to defaults.

Runs a command in a sandbox with workspace read/write.

--allow-paths, --readonly-paths, --blocked-patterns, --sandbox, --network, --sb-debug

Displays help for a sandbox command.

Starts a private cloud worker that connects to Cursor and runs agents in your environment.

start | debug | controller | help

Starts the worker and connects to Cursor. Waits for the bridge to connect before reporting ready.

--verbose

Runs private worker preflight diagnostics for auth, privacy, and routing.

--json

Displays help for a worker command.

Starts workers from a --spawn hook, either claim-then-spawn (default) or as a warm pool with --warm-idle. Authenticates with a service account key.

--spawn, --api-key, --pool, --all-pools, --warm-idle, --session-token, --identity-audience, --repository, --endpoint

Starts ACP (Agent Client Protocol) server mode over stdio with JSON-RPC 2.0, newline-delimited. Intended for custom clients and advanced integrations; hidden from default help output.

Updates Cursor Agent to the latest version. The CLI also tries to auto-update by default.

Opens previous chats so you can resume one.

Resumes the latest chat session.

Creates a new empty chat and returns its ID.

Generates a new Cursor rule with interactive prompts.

Installs shell integration to ~/.zshrc.

Removes shell integration from ~/.zshrc.

Displays help for a command.

Configures AWS Bedrock access with your own access keys or a team IAM role; works across interactive, headless, and editor sessions.

Starts a persistent session that keeps the agent running after you disconnect. Detach with /detach.

attach | list | stop; --resume

Reconnects to a persistent session later.

Lists persistent sessions (documented as agent persist list|stop for managing sessions).

Stops a persistent session (documented as agent persist list|stop for managing sessions).

Deploys a Cloud Agent environment from an environment file. Files can include comments and trailing commas; invalid files fail with a syntax error pointing to where parsing stopped.

environment file

Registers a plugin marketplace from the shell without an interactive session. Pin a branch, tag, or commit with --git-ref.

git URL; --git-ref

Prints each marketplace's name, scope, and git URL.

--format json for scripts

Re-indexes a marketplace from its repository.

Deletes a user-scoped marketplace.