用途:以 bash 为主,通过后台进程方式运行并控制 Codex CLI、Claude Code、OpenCode、Pi Coding Agent 等交互式编程智能体,实现程序化调用与批量任务处理。
主要能力:支持一次性任务(如 codex exec "prompt")、后台长任务,以及会话的轮询、日志查看、输入提交、按键发送、粘贴和终止;可与 git worktree 配合做并行 PR 审查与多问题修复。
必要用法:编程智能体是交互式终端应用,必须设置 pty:true,否则输出异常或挂起。常用参数包括 command、pty、workdir、background、timeout、elevated。Codex 需在受信任的 git 仓库中运行,临时任务可用 mktemp -d 加 git init。通过 process 工具以 sessionId 监控后台会话,动作有 list、poll、log、write、submit、send-keys、paste、kill。Pi 可用 npm install -g @mariozechner/pi-coding-agent 安装。
限制与注意:避免在特定项目目录中启动 Codex 或切换分支;不要自行手写补丁,应等待或重启失败挂起的智能体;后台任务开始、变化、结束或终止时应向用户同步进度;不要把“慢”当作终止理由。模型与价格等细节资料未提供。