用途:在 Sidecar 拥有的 shell 中启动并协调第二个智能体,命令均为无头、可指定目标且原生支持 --json,无需 TUI。
主要能力:发现 shell 与活动智能体;单独创建布局;启动 provider 并等待就绪;提示并等待;读取屏幕;发送逻辑按键;向多个智能体广播。
必要用法:智能体控制默认关闭,先运行 sidecar agent list --json,若返回 feature_disabled,需请用户自行在 ~/.config/sidecar/config.json 的 features.flags 中启用 agent_control。安全顺序:先 sidecar shell list --json 与 sidecar agent list --json 发现目标;用 sidecar create shell --tab --name reviewer --json 创建布局(不要用默认放置或 --split,否则不是受管 shell);再 sidecar agent start "$target" --kind codex --timeout 30s --json;提示用 sidecar agent prompt "$target" "..." --wait --timeout 2m --json;等待用 sidecar agent wait "$target" --until done --timeout 5m --json;读取用 sidecar agent read "$target" --source recent-unwrapped --lines 120;回答用 sidecar agent send-keys "$target" down enter;广播用 sidecar agent broadcast "..." --json。
限制:--wait 必须搭配 --timeout,无隐式超时;agent start 不会创建或移动窗格;send-keys 只用于回答 UI,提示文本应走 agent prompt;Sidecar 不自动回答审批,也不负责原始终端控制与工作流;--host 不在本切片内,--all 仅指本机。退出码 0 成功、1 传输失败或超时、2 用法错误、3 目标非注册 shell、5 功能禁用或语义拒绝。