为什么值得关注

它提供了安全、通用的 Herdr 代理控制运行时层，使用 execFile 避免 shell 注入，同时支持交互式斜杠命令和可编程的 LLM 工具。

适合谁使用

使用 Pi 并管理 Herdr 代理和窗格的用户
构建依赖 Herdr 控制的产品特定循环的开发者
任何使用 Pi 作为 AI 编码环境并需要代理生命周期管理的人

典型使用场景

使用自定义参数启动和停止 Herdr 管理的代理
读取代理窗格的最新输出以进行调试或监控
向运行中的代理发送命令或提交输入
列出活动代理及其窗格配置

项目优势

通过 execFile 安全传递参数，防止 shell 注入
延迟解析 herdr 二进制文件，避免在没有 Herdr 的机器上启动失败
同时提供斜杠命令（用于交互使用）和 LLM 工具（用于编程使用）
对于关闭终端等危险操作，要求显式确认

使用前须知

需要系统上安装并配置 Herdr
仅在 Pi 生态系统中可用，不是独立工具
停止命令需要手动确认，可能中断自动化工作流

README 快速开始

Bellwether 🐏🔔

Bellwether is a Pi package for managing Herdr agents, panes, and runtime sessions from Pi.

This is deliberately generic runtime plumbing. Product-specific loop control should depend on this package or adapt its commands/tools, not bury Herdr control inside a loop-specific extension.

Install

Install from GitHub:

pi install git:github.com/joelhooks/pi-bellwether

Or use a local checkout:

pi install /path/to/pi-bellwether

For a one-off smoke test without installing:

PI_OFFLINE=1 pi -e /path/to/pi-bellwether --help

Slash commands

/herdr-status — show Herdr client/server status.
/herdr-agents [--panes] — list detected Herdr agents, optionally with panes.
/herdr-start [--cwd PATH] [--workspace ID] [--tab ID] [--split right|down] [--env KEY=VALUE] [--focus|--no-focus] -- — start a managed agent/process.
/herdr-send — send literal text to a Herdr agent target.
/herdr-submit — press Enter in the target agent's pane.
/herdr-read [--lines N] [--source visible|recent|recent-unwrapped] [--ansi] — read recent output.
/herdr-focus — focus an agent target.
/herdr-stop — close the target agent's pane after confirmation.

Targets are whatever herdr agent accepts: terminal ids, pane ids, unique agent names, detected/reported labels, and legacy pane ids.

LLM tools

herdr_status
herdr_list_agents
herdr_start_agent
herdr_send_message
herdr_submit
herdr_read_agent
herdr_focus_agent
herdr_stop_agent

herdr_stop_agent requires confirm: true because it closes a terminal pane. Read/list first, stop second. FFS, don't let the robot blindly close terminals.

Development

npm install --ignore-scripts
npm run check
npm run smoke
pi-notes brain check

The extension uses execFile, not shell strings, so command arguments are passed without shell injection. It lazily resolves the herdr binary when a command/tool runs, so Pi startup does not fail on machines without Herdr installed.

项目描述

Bellwether 🐏🔔 — Pi package for managing Herdr agents, panes, and runtime sessions from Pi

pi-bellwether