用途:以 bash 优先的方式调用编程智能体(Codex CLI、Claude Code、OpenCode、Pi Coding Agent),通过后台进程实现程序化控制,适合一次性任务、批量 PR 审查与并行修复 issue。
主要能力:bash 工具支持 command、pty、workdir、background、timeout、elevated 参数;后台会话可用 process 工具的 list、poll、log、write、submit、send-keys、paste、kill 操作监控与交互。Codex 支持 exec 一次性执行、--full-auto 自动批准、--yolo 无沙箱无审批;Pi 支持 -p 非交互模式及 --provider/--model 指定模型。
必要用法:运行编程智能体必须设置 pty:true,否则输出损坏或挂起。示例:bash pty:true command:"codex exec 'Your prompt'"。Codex 需在受信任的 git 目录内运行,临时任务可 SCRATCH=$(mktemp -d) && cd $SCRATCH && git init。长任务用 workdir + background + pty,返回 sessionId 后用 process action:log/poll 监控。Pi 安装:npm install -g @mariozechner/pi-coding-agent。
适用场景:一次性构建、PR 审查(克隆到临时目录或用 git worktree)、批量并行 PR 审查、用 git worktree 并行修复多个 issue。
限制与规则:始终使用 pty:true;尊重用户指定的工具;编排模式下不要自行手写补丁;智能体失败或挂起时应重启或询问用户,不要静默接管;不要因“慢”而终止会话;不要在特定项目目录中启动 Codex 或检出分支;后台任务需向用户同步进度,可用 moltbot gateway wake 在完成时通知。