Herdr agent start教程：程序化启动AI代理并等待就绪

Herdr agent start教程程序化启动AI代理并等待就绪【免费下载链接】herdrthe runtime your coding agents live on项目地址: https://gitcode.com/GitHub_Trending/her/herdrHerdr 是一款让 AI 编程代理Coding Agent常驻运行的后台运行时herdr agent start命令让你可以从命令行程序化启动Claude Code、Codex 等 AI 代理自动等待其就绪后再派发任务。本教程带你用 3 条命令完成从启动代理到等待就绪的完整自动化流程。herdr agent start 是什么herdr agent start是 Herdr CLI 的核心自动化命令之一。它做三件事启动在你指定的面板pane里启动一种受支持的 AI 代理识别Herdr 自动检测屏幕内容确认代理进程真的运行起来了等待就绪命令会阻塞直到代理进入可交互状态才返回——你拿到的永远是一个能干活的代理而不是一个正在加载的界面。 这正是它比手动在终端里敲claude或codex强的地方脚本可以放心地agent start→agent prompt→agent wait全程无需人眼盯屏幕。准备安装 Herdr 并创建工作区如果你还没安装 Herdr任选其一brew install herdr # 或 mise use -g herdr # 或从源码构建 git clone https://gitcode.com/GitHub_Trending/her/herdr cd herdr cargo build --release然后在你的项目目录下启动 Herdr它是后台服务器关闭终端后代理仍会继续运行cd ~/my-project herdr三步教程程序化启动一个 AI 代理步骤 1创建面板并获取 pane IDagent start需要一个空闲的 shell 面板shell 位于提示符、没有前台命令在跑。创建面板并记录 IDcreated$(herdr workspace create --cwd ~/my-project --label api --no-focus) pane_id$(printf %s\n $created | jq -r .result.root_pane.pane_id)创建命令都会输出 JSON从返回值里捕获 ID不要自己猜测。已有面板时也可用herdr pane split --current --direction right --no-focus再分一个。步骤 2用 herdr agent start 启动代理herdr agent start reviewer --kind codex --pane $pane_id命令格式herdr agent start name --kind KIND --pane ID [--timeout MS] [-- agent-args...]参数必填说明name✅代理名需匹配[a-z][a-z0-9_-]{0,31}且在所有存活代理中唯一--kind KIND✅代理类型如claude、codex、gemini、cursor、opencode、grok等共 22 种--pane ID✅目标面板必须是空闲 shell 面板--timeout MS⬜等待就绪的超时默认30000范围3001~300000-- agent-args⬜--之后的参数原样传给代理可执行文件比如给 codex 指定模型herdr agent start reviewer --kind codex --pane w1:p2 -- -m gpt-5.4。命令成功返回就代表代理已在该终端中被识别并等待就绪可以直接对话了。步骤 3派发任务并等待完成herdr agent prompt reviewer Review the current diff --wait --timeout 120000 herdr agent read reviewer --source recent-unwrapped --lines 120agent prompt --wait发送任务并等待代理进入稳定状态默认idle/done/blockedagent wait reviewer --until blocked --timeout 120000单独等待代理需要人回答的时刻agent read读取代理屏幕输出检查它说了什么agent send-keys reviewer enter向代理的交互界面发送按键。一个完整的自动化脚本示例#!/usr/bin/env bash set -euo pipefail # 1. 创建工作区拿到根面板 created$(herdr workspace create --cwd ~/my-project --label api --no-focus) pane_id$(printf %s\n $created | jq -r .result.root_pane.pane_id) # 2. 程序化启动 codex 代理等待就绪最多 60 秒 herdr agent start reviewer --kind codex --pane $pane_id --timeout 60000 # 3. 派发任务并等待完成 herdr agent prompt reviewer Review the current diff and list issues --wait --timeout 300000 # 4. 读取结果 herdr agent read reviewer --source recent-unwrapped --lines 120常见错误速查错误含义处理办法agent_pane_busy面板里有前台进程没退出让面板回到 shell 提示符CLI 会自动重试约 2 秒等待 shell 初始化agent_not_ready启动时检测到代理处于blocked如提问/审批界面用agent read查看再agent send-keys手动应答timeout在--timeout内未就绪调大超时最大300000毫秒unsupported interactive agent kind--kind写错从 22 种受支持类型中选claude、codex、gemini、cursor、opencode等⚠️ 注意代理名是当前面板住户的别名代理退出或被替换后名字会清空面板 ID如w1:p2才是稳定的位置标识。延伸阅读自动化完整指南含三大原语 layout / pane / agent 的分工agent-automation.mdxCLI 全部命令与选项cli-reference.mdxagent start参数解析与就绪等待的源码实现agent.rs上手总览quick-start.mdx让 Claude Code 自己学会操作 Herdr 的技能文件SKILL.md【免费下载链接】herdrthe runtime your coding agents live on项目地址: https://gitcode.com/GitHub_Trending/her/herdr创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考