用途:在 Eliza 中通过 bash 工具(可配合后台模式)以编程方式启动、监控和控制编码代理,支持 Codex CLI、Claude Code、OpenCode 和 Pi Coding Agent。
主要能力:bash 工具支持 command、pty、workdir、background、timeout、elevated 参数;后台会话可用 process 工具的 list、poll、log、write、submit、send-keys、paste、kill 等动作管理。可执行一次性任务、后台长任务、PR 审查、并行批量审查,以及用 git worktree 并行修复多个 issue。
必要用法:编码代理是交互式终端程序,必须使用 pty:true,否则输出异常或挂起。Codex 需在受信任的 git 目录中运行,临时任务可先 mktemp -d && git init。示例:bash pty:true command:"codex exec 'Your prompt'";后台:bash pty:true workdir:~/project background:true command:"codex exec --full-auto 'Build a snake game'"。Claude Code 用 claude 'Your task',OpenCode 用 opencode run 'Your task',Pi 用 pi 'Your task'(安装:npm install -g @mariozechner/pi-coding-agent)。
适用场景:构建/创建、PR 审查、批量并行审查、并行修复 issue 等。
限制:仅直接下载版 Eliza 可用,商店版(Mac App Store、Microsoft Store、Flathub)因 OS 沙箱禁止 fork 用户安装的二进制而被禁用,检测到 ELIZA_BUILD_VARIANT=store 时只注册被阻止的 TASKS 动作。门控逻辑为 @elizaos/core 中的 isLocalCodeExecutionAllowed()。不要在 Otto 自身项目目录审查 PR,不要在 ~/Projects/otto/ 检出分支。代理失败或挂起时应重新启动或询问用户,不要静默接管。