agent [prompt...]

以标准 Agent 模式启动 Cursor CLI,也可以在参数中直接带上一个 Prompt。

不带任何子命令执行 agent,会以 Agent 模式启动一个交互式会话——这是拥有完整工具访问权限(读取、写入、Shell 命令、Web)的默认模式。如果带上可选的 Prompt 参数,它会作为第一条消息直接发送,例如 agent "refactor the auth module to use JWT tokens"。不带参数时会打开一个空的聊天窗口。对于非交互式运行(脚本、CI),另有 -p/--print 参数,让它只输出最终的回答。

✅ 什么时候用？

直接带着具体任务开始,不用先手动输入

agent "fix the failing tests in src/auth"

在还没有明确任务时,启动一个用于探索的交互式会话

agent — 然后在聊天中逐步明确目标并澄清疑问

⛔ 什么时候不该用？

需要在脚本或 CI 任务中无人值守地运行

标准 Agent 模式会在执行命令前交互式请求确认,这会阻塞无人值守的运行。

更好的选择: 组合使用 -p 和 --force,例如 agent -p --force "<prompt>"(参见 Global Options 汇总条目)

只想读取/分析,不希望有文件改动

标准模式拥有完整的写入和 Shell 访问权限。

更好的选择: 启动时设置 --mode ask,或启动后使用 /ask

来源

Cursor 官方文档——CLI 参考:参数(Parameters) ↗ cursor.com
Cursor 官方文档——CLI 概览(Overview) ↗ cursor.com