Conductor(conductor.build)是用于并行智能体(parallel-agent)的应用,核心区分在于:本地工作区用 conductor:// 深链创建,云工作区用 CLI 或 API 创建;CLI 无法创建本地工作区。
用途与主要能力:在 Mac 上为每个任务创建独立 git worktree 工作区,分支名由提示词文本推导,并运行 scripts.setup;云工作区运行在 Linux 上,可创建会话、发送消息、管理项目与工作区。
本地工作区用法:把任务简报写入文件,用 Python 对 prompt 与 path 做百分号编码(safe=''),生成 conductor://prompt=...&path=... 后 open。path 必须是已注册 git 仓库根目录,无尾斜杠。注意:prompt 只在输入框中预填,必须人工按回车才会运行,深链无法自动执行;open 退出码 0 不代表成功,需用 git worktree list 或查看应用验证。
CLI 位置:/usr/local/bin/conductor 常是 Orkes/Netflix Conductor,真正的是 /Applications/Conductor.app/Contents/Resources/bin/conductor,可用 conductor --help 确认(列出 auth、projects、workspaces、sessions、messages、models、sql)。
云工作区:conductor workspaces create 支持 --project-id、--repo-url、--branch、--name、--agent、--model、--effort、--env、--channel 等;后续可用 conductor sessions create、conductor messages create。云为 Linux,Mac 专用 setup 脚本会部分失败;云中 CONDUCTOR_PORT 未设置,CONDUCTOR_ROOT_PATH 等于工作区路径。
认证:云命令需 macOS Keychain 中的令牌,用 conductor auth status、whoami、login --token 管理;API 基址 https://api.conductor.build/v0,Bearer 认证。
其他:环境变量 CONDUCTOR_IS_LOCAL、CONDUCTOR_WORKSPACE_NAME/ID/PATH、CONDUCTOR_ROOT_PATH、CONDUCTOR_DEFAULT_BRANCH、CONDUCTOR_PORT;退出码 0 成功、1 运行时、2 用法、3 认证、4 服务端;列表命令默认分页小,可用 --limit(最大 100)与 --offset,或优先用 conductor sql 查询。设置优先级为 managed > repo local > repo shared > user > defaults,TOML 优先于旧 JSON。
限制:本地深链不能自动运行;云与本地深链语法不同,云对象应读取响应中的 deepLink;官方无 /docs/reference/cli 页面。其余细节以官方文档为准。