agent worker start

启动私有 Worker,并将其连接到 Cursor。

agent worker start 会启动私有 Worker 进程并连接到 Cursor,让云端 Agent 任务在自己的环境中运行,而不是在 Cursor 的云端。可以通过 --worker-dir(工作区根目录,可重复指定,第一个值决定分配身份)、--name、--label/--labels-file、--pool/--pool-name、--idle-release-timeout,以及用于 /healthz、/readyz、/metrics 的 --management-addr 等参数进行配置。--verbose 会开启详细的启动日志。

✅ 什么时候用？

同时把多个仓库暴露为 Worker 工作区

agent worker start --worker-dir ~/repos/app-a --worker-dir ~/repos/app-b

暴露健康检查/指标(Metrics)端点,方便监控 Worker

agent worker start --management-addr 0.0.0.0:9100

⛔ 什么时候不该用？

想在真正启动前先确认身份验证和网络是否正常

agent worker start 会立即以生产状态连接,事先没有单独的检测环节。

更好的选择: 先运行 agent worker debug,再执行 agent worker start

只需要单次、简短的 Agent 运行

agent worker start 启动的是一个与 Cursor 保持连接、长期运行的进程。

更好的选择: 使用 agent 或 agent -p 的普通会话,而不是运行一个 Worker

来源

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