Team Pools 与仓库路由

Pool 是可选择的路由目标，请求排队等待空闲 worker claim。每个 pool worker 同时服务一个 Agent；多个任务并行需要多个 worker。

前提与启动

需要 Enterprise、管理员允许 Self-Hosted Machines，以及服务账号 API Key。个人登录和个人/用户 key 不能启动 pool worker。

export CURSOR_API_KEY="your-service-account-api-key"
agent worker --pool my-pool --worker-dir /path/to/repo start

不提供名称时加入 default。当前专题页使用 --pool [name]；旧 --pool-name 为弃用别名，--single-use 是旧兼容入口。通用 CLI 参数页仍展示旧格式，实际安装版本需用帮助核对。

仓库根与标签

--worker-dir 最多重复 20 个已存在目录，首项决定 assignment identity 与 dashboard 主仓库显示；全部根提供给运行时，有 Git remote 的根注册仓库路由。

更多根不自动把更多仓库加入请求。普通 repo-backed pool 请求仍选择一个仓库，其他根的 Git 操作用机器已有凭据。检查 verbose 日志中的 workspacePaths 和 x-repository-urls 确认注册范围。

标签可用 --label key=value 或 --labels-file JSON/TOML，二者互斥。repo 和 pool 为保留标签，分别从 Git remote 和 pool 参数生成，不应手动填写。

Any-repo 池

无绑定仓库的命名 pool 按 pool 名匹配，默认不克隆。需要自动准备请求仓库时：

agent worker --pool my-pool --clone-git-repos start

此开关只支持非 default、无绑定 repo、无绑定 machine 的 any-repo pool，隐含 --mint-github-token，并需管理员允许 mint、PATH 中有 git。使用 HTTPS GitHub remote；完整 40 字符 SHA 使用 detached checkout。

可复用 worker 目录中干净且 origin 匹配的 checkout；存在未提交修改、本地领先提交、进行中的 Git 操作、submodule 或额外配置等不安全状态时，另克隆目录。复用需 Git 2.26 或以上。claim 结束后删除本次克隆内容，保留复用的 checkout。

凭据与分发

--sync-dashboard-secrets 需管理员开启 Secret sync，接收团队/用户 secrets 和 API envVars；any-repo 只接收未限制到仓库的 secrets，不接收环境范围或 Build Secrets。

启用克隆、token mint 或 secret sync 的 worker 必须每容器或 OS 用户仅一个，不能同用户共置多个凭据 worker。运行池的扩容与回收见Controller。