全局选项
| 选项 | 描述 |
|---|---|
-v, --version | 输出版本号 |
-a, --api-key <key> | 用于认证的 API 密钥（也可使用环境变量 CURSOR_API_KEY） |
-p, --print | 将响应打印到控制台（适用于脚本或非交互式场景）。可使用所有工具，包括 write 和 bash。 |
--output-format <format> | 输出格式（仅在使用 --print 时生效）：text、json 或 stream-json（默认：stream-json） |
-b, --background | 以后台模式启动（启动时打开 composer 选择器） |
--fullscreen | 启用全屏模式 |
--resume [chatId] | 恢复聊天会话 |
-m, --model <model> | 使用的模型 |
-f, --force | 强制允许执行命令，除非被明确拒绝 |
-h, --help | 显示命令帮助 |
命令
| 命令 | 描述 | 用法 |
|---|---|---|
login | 通过 Cursor 进行身份验证 | cursor-agent login |
logout | 登出并清除已存储的认证信息 | cursor-agent logout |
status | 查看认证状态 | cursor-agent status |
mcp | 管理 MCP 服务器 | cursor-agent mcp |
update|upgrade | 将 Cursor Agent 更新到最新版本 | cursor-agent update 或 cursor-agent upgrade |
ls | 列出并选择要恢复的聊天会话 | cursor-agent ls |
resume | 恢复最近的聊天会话 | cursor-agent resume |
help [command] | 显示命令帮助 | cursor-agent help [command] |
当未指定命令时，Cursor Agent 默认以交互式聊天模式启动。
MCP
| Subcommand | Description | Usage |
|---|---|---|
login <identifier> | 与 .cursor/mcp.json 中配置的 MCP 服务器进行身份验证 | cursor-agent mcp login <identifier> |
list | 列出已配置的 MCP 服务器及其状态 | cursor-agent mcp list |
list-tools <identifier> | 列出指定 MCP 的可用工具及其参数名 | cursor-agent mcp list-tools <identifier> |
-h, --help 查看特定命令的帮助。
参数
prompt— 代理的初始提示词
获取帮助
-h, --help，用于显示该命令的专属帮助信息。