agent worker

用于启动私有云端 Worker 的顶层命令,让 Agent 任务在自己的环境中运行。

agent worker 会把自己的机器连接到 Cursor,让云端 Agent 任务在自己的环境中运行,而不是在 Cursor 自家的云环境中(自托管)。包含 start 和 debug 子命令。可以通过 --worker-dir、--name、--label 或 --labels-file、--pool 或 --pool-name、--idle-release-timeout 等参数来配置 Worker。

✅ 什么时候用？

为云端 Agent 运行提供自己的硬件/环境(出于隐私或特殊工具的需要)

agent worker start --name build-worker-1 --worker-dir ~/repos/myapp

把多个 Worker 注册成一个供云端 Agent 调用的资源池(Pool)

agent worker start --pool --pool-name ci-pool

⛔ 什么时候不该用？

只需要单次本地 Agent 运行

agent worker 启动的是一个与 Cursor 保持连接、长期运行的进程,用于云端 Agent 的任务交接,而不是一次性运行。

更好的选择: 使用 agent 或 agent -p 进行普通的交互式会话

想在真正启动前先检查配置或连接是否正常

agent worker start 会立即连接;身份验证、隐私或路由方面的问题只有在那之后才会暴露出来。

更好的选择: 先运行 agent worker debug 查看预检(Preflight)诊断结果

来源

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