​
全局选项

全局选项可用于任意命令：
选项说明
-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显示命令帮助

​
命令

CommandDescriptionUsage
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

管理为 Cursor Agent 配置的 MCP 服务器。
子命令描述用法
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>
所有 MCP 命令都支持 -h, --help 查看该命令的帮助。

​
参数

在聊天模式下启动时（默认行为），你可以提供一个初始提示： 参数：
  • prompt — 智能助手的初始提示

​
获取帮助

所有命令都支持全局 -h, --help 选项来显示命令相关的帮助信息。