cursor 命令

常用示例

说明

cursor-agent is Cursor's terminal-native AI coding assistant. It mirrors the same agent loop the Cursor editor uses, but in a plain terminal so it can live alongside Vim, Neovim, Emacs, JetBrains IDEs, or CI pipelines. Sessions are persistent and resumable. Print mode makes the agent scriptable — combine `--output-format json` with shell tooling to pipe agent output into other programs. The CLI uses the same subscription and model quota as the Cursor editor. Cloud Agent (triggered in-session) offloads long-running tasks to Cursor's servers so the local shell stays responsive.

参数

-p, --print

Print mode: run the prompt non-interactively, stream the response, then exit.

--output-format _FORMAT_

`text` (human readable, default), `json` (single result object), or `stream-json` (NDJSON event stream).

--stream-partial-output

Emit incremental token deltas rather than complete messages.

--model _NAME_

Model to use (run `cursor-agent models` for the current list).

--mode _MODE_

`agent` (default), `plan`, or `ask`.

--plan

Shorthand for `--mode plan`.

--continue

Continue the most recent session (shorthand for `--resume` with no id).

--resume _chat-id_

Resume a specific chat.

-f, --force, --yolo

Run all tool calls without prompting (except explicitly denied ones).

--sandbox _MODE_

Sandbox behavior: `enabled` or `disabled`.

--trust

Trust the workspace without prompting (required for headless runs).

--approve-mcps

Automatically approve all configured MCP servers.

--workspace _PATH_

Working directory to use instead of the current one.

--worktree

Create a new Git worktree under `~/.cursor/worktrees` and run there.

--api-key _KEY_

API key (env: `CURSOR_API_KEY`).

-H, --header _"Name: Value"_

Add a custom header to requests.

-v, --version

Print the version.

-h, --help

Show help for the command.