Cursor CLI
Cursor's terminal agent — runs as the »agent« binary in your terminal, in scripts and CI.
ALL COMMANDS · 80
/modelSwitches the active AI model in the running CLI session./run-everythingToggles 'Run Everything' autopilot mode, which runs commands without asking for approval./planSwitches to Plan mode, where the agent drafts a plan before acting./askToggles Ask mode, where the agent only reads and makes no changes./debugToggles Debug mode, built for reproducing and narrowing down bugs./logsShows the path to the current debug log file and copies it to the clipboard./updateUpdates Cursor Agent to the latest version directly from the running session./max-modeToggles 'Max Mode' for the currently selected model, if supported./renameRenames the current chat session./clearStarts a new, empty chat session./resumeOpens a list of recent chats across all workspaces and resumes one./forkBranches the current chat into a new session, the original stays untouched./summarizeSummarizes the conversation to free up space in the context window./rewindJumps back to an earlier message via an interactive timeline and restores files/conversation./vimToggles Vim keybindings in the input field./line-numbersToggles line numbers in displayed code blocks./show-thinkingToggles display of the model's thinking blocks./status-indicatorsToggles status indicators in the terminal title./shellSwitches to Shell mode to run short commands directly without leaving the conversation./aboutShows CLI version, system, and account info and copies it to the clipboard./setup-terminalConfigures terminal newline keybindings to match the detected terminal./helpShows help; with a command name as an argument, shows details for that command./feedbackSends feedback directly to the Cursor team./openOpens the current repo's Git root directory in the Cursor editor./copy-request-idCopies the last request's ID to the clipboard./copy-conversation-idCopies the current conversation's ID to the clipboard./logoutSigns out of the current Cursor account./quitExits the current CLI session./exitExits the current CLI session, identical to /quit./mcpManages MCP servers via an interactive menu: log in, list, view tools./pluginManages plugins and plugin marketplaces./configOpens an interactive editor for CLI settings./copyCopies an earlier own message to the clipboard./sandboxConfigures sandbox mode and network access via an interactive menu./bedrockConfigures AWS Bedrock as the model backend, if the Bedrock feature is enabled./add-dirAdds another directory to a multi-root session at runtime./save-workspaceSaves the currently active multi-root directories as a named workspace set./load-workspaceLoads a multi-root workspace set previously saved with /save-workspace./auto-reviewToggles 'Auto-review' run mode, a middle ground between allowlist and Run Everything./contextVisualizes what's consuming the context window, broken down by category./full-conversationTurns off the performance-optimized short rendering and shows the full conversation history./btwAsks a quick, read-only side question mid-turn, without adding to the chat history./skillsBrowses available skills; individual skills can also be invoked directly via /skill-name./rulesInteractive browser for viewing and editing the loaded Cursor rules./commandsInteractive browser for viewing and editing your own custom commands./changesOpens the unified review UI for proposed file changes (Ctrl+R)./opus, /composer, /fastModel shortcuts: jump straight to a model family or toggle Fast mode, without opening the model picker.agent [prompt...]Starts the Cursor CLI in default agent mode, optionally with a prompt passed directly as an argument.agent loginAuthenticates the CLI with your Cursor account through the browser login flow.agent logoutSigns the CLI out of your Cursor account and clears locally stored credentials.agent status | agent whoamiShows the current authentication status plus account and endpoint info.agent aboutShows version, system, and account info for the CLI installation.agent modelsLists all models available for the account.agent mcpParent command for managing configured MCP servers (login, list, tools, enable/disable).agent sandboxParent command, hidden from default help, for configuring sandbox mode or running one command in isolation.agent workerParent command for starting a private cloud worker that runs agent tasks in your own environment.agent acpStarts the CLI in ACP server mode (Agent Client Protocol) for editor and client integrations.agent updateUpdates Cursor Agent to the latest version.agent lsOpens a list of previous chats to pick one to resume.agent resumeResumes the most recently used chat session directly, without showing a selection list.agent create-chatCreates a new, empty chat and returns its ID, e.g. for use in scripts.agent generate-rule | agent ruleWalks through interactive prompts to generate a new Cursor rule.agent install-shell-integrationInstalls the CLI's shell integration into ~/.zshrc.agent uninstall-shell-integrationRemoves the CLI's shell integration from ~/.zshrc again.agent help [command]Shows help for the CLI or for a specific command.agent mcp login <identifier>Authenticates with an MCP server configured in mcp.json.agent mcp listLists configured MCP servers and their status (connected/disconnected, source, transport).agent mcp list-tools <identifier>Lists the available tools and their parameters for a specific MCP server.agent mcp enable <identifier>Adds an MCP server to the locally approved list.agent mcp disable <identifier>Disables an MCP server so it stops loading or prompting for approval.agent sandbox enableEnables sandbox mode for command execution.agent sandbox disableDisables sandbox mode and falls back to allowlist mode instead.agent sandbox resetResets the sandbox configuration to its default values.agent sandbox run <cmd> [args...]Runs a single command in a sandbox with read/write access to the workspace.agent sandbox help [command]Shows help for the sandbox subcommands.agent worker startStarts the private worker and connects it to Cursor.agent worker debugRuns preflight diagnostics for the private worker (auth, privacy, routing).agent worker help [command]Shows help for the worker subcommands.agent bedrockConfigures AWS Bedrock as a model backend with your own credentials or a team IAM role.Global Options (Flags)Collects the most important global flags of the Cursor CLI that can be combined with any command.