@muzi3/herdr

Herdr for pi: the herdr operate skill (control Herdr from inside a pane), the herdr-guide skill (teach a human to set up and troubleshoot Herdr), and the herdr-agent-state extension (report agent state to Herdr).

Packages

Package details

extensionskill

Install @muzi3/herdr from npm and Pi will load the resources declared by the package manifest.

npm repo report
$ pi install npm:@muzi3/herdr
Package
@muzi3/herdr
Version
0.1.0
Published
Aug 26, 2026
Downloads
115/mo · 12/wk
Author
muzi3
License
Apache-2.0
Types
extension, skill
Size
29.2 KB
Dependencies
0 dependencies · 0 peers
Pi manifest JSON
{
  "extensions": [
    "./extensions"
  ],
  "skills": [
    "./skills"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

@muzi3/herdr

Herdr 相关的官方 guide skill 与一个扩展打包为一个 pi package。

资源 类型 说明
herdr-guide user-invoked 向导 引导用户理解、安装、配置与排查 Herdr（herdr.dev/agent-guide.md）
herdr-agent-state 扩展 通过 Herdr 的 pane socket 上报 agent 状态（working / blocked / idle）及会话引用，供 Herdr 面板展示

来源与许可

两者内容均来自 Herdr 官方，上游仓库为 herdrdev/herdr：

  • herdr-guide 引导 skill —— 官方 herdr.dev/agent-guide.md，教 agent 引导用户理解/配置/排障 Herdr
  • herdr-agent-state 扩展 —— Herdr 官方 pi 集成的 bundled 扩展，由 herdr integration install pi 自动写入 ~/.pi/agent/extensions/herdr-agent-state.ts（若设置 PI_CODING_AGENT_DIR 则写入 $PI_CODING_AGENT_DIR/extensions/）

Herdr 以 Apache-2.0 许可发布，本包保留其许可声明，详见 LICENSE。

扩展源文件由 Herdr 集成管理，重装或更新集成时会覆盖；请在旁边添加自定义 hooks 而非编辑它。

安装

pi install npm:@muzi3/herdr

用法

  • 用户询问 Herdr 是什么、怎么安装/配置/使用，或排查 agent 未识别、快捷键失效等问题时，触发 herdr-guide 引导（/herdr-guide）
  • 触发词：herdr / herdr 安装 / herdr 配置 / 终端工作区 / agent 状态检测 等

扩展环境变量

扩展需在 Herdr 集成环境中运行，依赖以下环境变量：

变量 说明
HERDR_ENV 为 1 时启用
HERDR_SOCKET_PATH Herdr pane socket 路径
HERDR_PANE_ID 当前 pane id

未设置这些变量时扩展静默跳过。扩展行为：agent_start / agent_settled 时上报 working / idle，herdr:blocked 事件上报 blocked，session_start 时上报会话引用。

参考