Herdr JSON Output与jq脚本里解析创建命令返回值【免费下载链接】herdrthe runtime your coding agents live on项目地址: https://gitcode.com/GitHub_Trending/her/herdrHerdr 是编码智能体coding agent驻留的终端运行时它管理会话、工作区workspace、标签页tab和窗格pane。Herdr 的 CLI 创建类命令默认输出结构化 JSON配合jq可以在脚本里精确提取返回的workspace_id、tab_id、pane_id不再靠肉眼猜 ID——这就是用 Herdr JSON 输出做自动化编排的核心技巧。为什么创建命令返回 JSON 而不是纯文本在 CLI 参考文档 中明确写道大多数命令会输出 JSON 响应以便在脚本中做确定性自动化。所有 API 响应共用同一个信封结构{ id: cli:request, result: { type: workspace_created, ...: ... } }成功时result里携带创建结果失败时error对象写到stderr进程退出码为1参数写错用法错误则退出码为2。响应字段在源码 src/api/schema/response.rs 中定义例如WorkspaceCreated一次返回workspace、tab、root_pane三段信息。创建命令返回值速查表记住这三条提取路径就能覆盖绝大多数脚本场景命令关键 JSON 路径说明herdr workspace create.result.workspace.workspace_id、.result.tab.tab_id、.result.root_pane.pane_id创建工作区会连带创建首个 tab 和根窗格herdr tab create.result.tab.tab_id、.result.root_pane.pane_id新标签页及其根窗格herdr pane split.result.pane.pane_id返回新窗格 ID 不要预测 ID比如假设下一个是w1:p2——始终从响应里读取脚本才可靠。用 jq 一行提取 pane_id最典型的用法创建工作区后立刻拿到根窗格 ID后续命令直接引用created$(herdr workspace create --cwd ~/project --label api --no-focus) pane_id$(printf %s\n $created | jq -r .result.root_pane.pane_id) split$(herdr pane split $pane_id --direction right --no-focus) review_pane$(printf %s\n $split | jq -r .result.pane.pane_id)--no-focus表示创建时不抢占 UI 焦点适合在脚本里批量搭建布局。tab create同理不加--workspace时会作用于当前活动工作区没有活动工作区则报错。完整示例建布局 → 启动智能体 → 等待结果把提取的pane_id传给agent start一个完整的自动化闭环就形成了split$(herdr pane split --current --direction right --no-focus) review_pane$(printf %s\n $split | jq -r .result.pane.pane_id) herdr agent start reviewer --kind codex --pane $review_pane herdr agent prompt reviewer Review the current diff --wait --timeout 120000同样的思路也适用于worktree create返回workspace、tab、root_pane、worktree四段以及pane move之后用.result.move_result.pane.pane_id继续引用窗格。在脚本里稳健处理错误先判断退出码1表示服务端/超时错误错误 JSON 在 stderr2表示命令用法错误stderr 里就是 JSON需要时同样可以用jq解析不必正则匹配人类可读文本等待类命令pane wait-output、agent wait不带--timeout时会无限等待脚本里建议显式传超时。用官方 schema 核对字段不确定某个响应有哪些字段时别翻文档猜——安装的二进制自带完整 JSON Schemaherdr api schema --json | jq .schemas | keys herdr api schema --output herdr-api.schema.json仓库中的 schema 源文件为 docs/next/api/herdr-api.schema.json可用jq或任何 JSON Schema 工具本地查询。进一步阅读全部命令与输出格式CLI 参考智能体编排与 jq 提取的完整配方Agent 自动化创建命令的 CLI 实现src/cli/runtime.rs响应结构定义src/api/schema/response.rs掌握result信封 jq -r提取路径 退出码判断这三件套你的 shell 脚本就能像调用本地函数一样可靠地驱动 Herdr 创建命令了 【免费下载链接】herdrthe runtime your coding agents live on项目地址: https://gitcode.com/GitHub_Trending/her/herdr创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考