Herdr + Oh My Pi：我的多 AI Agent 编程工作流

本文介绍 Herdr、Pi 与 Oh My Pi（OMP）之间的关系，以及如何在 Windows 和 macOS 上完成安装和配置。重点讲解如何在 Herdr 中运行 Pi/OMP、配置 Agent Integration，并通过 Pane、Session 和多 Agent 协作打造更高效的 AI 编程工作流。

2026-08-11 17:17:34

3 热度

1 浏览

最近 AI Coding Agent 越来越多，比如：

Claude Code
Codex
Pi
Oh My Pi
OpenCode
Hermes

平时只用一个 Agent 时，一个终端窗口就够了。

但如果你开始让 AI 同时处理前端、后端、Bug 修复、Code Review，再加上一个终端跑开发服务器，很快就会变成：

text 复制代码

PowerShell
PowerShell
PowerShell
Windows Terminal
Terminal
Terminal
...

这时候 Herdr 就比较有用了。

简单来说：

Pi / Oh My Pi 负责写代码，Herdr 负责管理这些 AI Coding Agent。

可以把 Herdr 理解成一个专门为 AI Coding Agent 设计的现代终端多路复用器。

一、Herdr 是什么？

Herdr 是一个 Agent Multiplexer。

它本身不是 AI Coding Agent，也不会替代 Claude Code、Codex、Pi 或 Oh My Pi。

它负责的是：

text 复制代码

Herdr
│
├── Pane 1 → Oh My Pi
├── Pane 2 → Codex
├── Pane 3 → Claude Code
└── Pane 4 → npm run dev

也就是说，一个 Herdr 界面里，可以同时运行多个真正的 Shell 和多个 AI Agent。

Herdr 还针对常见 Coding Agent 提供了 Integration，可以获取 Agent 的生命周期状态和 Session 信息，例如：

text 复制代码

working
idle
blocked

并支持在 Herdr Session 恢复时恢复部分 Agent 的原生会话。Pi 和 OMP 都属于 Herdr 官方提供生命周期集成的 Agent。

二、Pi 是什么？

Pi 是一个运行在终端中的 AI Coding Agent。

它的设计比较简洁，核心功能之外可以通过：

text 复制代码

Extensions
Skills
Prompt Templates
Themes
Packages

进行扩展。

Pi 官方目前提供 npm 安装方式：

bash 复制代码

npm install -g --ignore-scripts @earendil-works/pi-coding-agent

安装完成后运行：

bash 复制代码

pi

即可启动。

在 macOS 和 Linux 上，还可以直接使用官方安装脚本：

bash 复制代码

curl -fsSL https://pi.dev/install.sh | sh

Pi 官方文档目前同时提供以上两种安装方式。

三、Oh My Pi 又是什么？

如果你看到的是：

bash 复制代码

omp

那么使用的并不是原版 Pi，而是 Oh My Pi。

Oh My Pi，简称：

text 复制代码

OMP

它源自 Pi，但加入了更多偏 Coding 场景的能力，例如：

LSP
Debugger
Subagent
Code Review
浏览器能力
Session
Git / GitHub 集成
Memory
更多内置开发工具

OMP 官方仓库将自己描述为 Pi 的 Fork，目前使用：

bash 复制代码

omp

作为 CLI 命令。

所以一定要区分：

text 复制代码

原版 Pi
命令：pi

Oh My Pi
命令：omp

本文后面的实际使用主要以 Oh My Pi（OMP） 为例。

四、Herdr 和 Pi 到底是什么关系？

两者不是竞争关系，而是在不同层级。

可以理解成：

text 复制代码

                Herdr
                  │
        ┌─────────┼─────────┐
        │         │         │
        ▼         ▼         ▼
       OMP      Codex    Claude Code
        │
        ▼
      AI 模型

其中：

Herdr

负责：

text 复制代码

终端
Pane
Tab
Workspace
Agent 状态
Session

而：

Pi / OMP

负责：

text 复制代码

读取代码
修改代码
执行命令
分析项目
修复 Bug
开发功能

一句话总结就是：

Herdr 管 Agent，Pi / OMP 干活。

五、Windows 安装 Herdr

Herdr 目前的 Windows 原生版本仍然属于 Preview Beta，而 Linux 和 macOS 已经提供稳定版本。

打开 PowerShell：

powershell 复制代码

powershell -ExecutionPolicy Bypass -c "irm https://herdr.dev/install.ps1 | iex"

安装完成之后建议：

text 复制代码

关闭当前 PowerShell
↓
重新打开 PowerShell

然后检查版本：

powershell 复制代码

herdr --version

启动 Herdr：

powershell 复制代码

herdr

如果出现：

text 复制代码

herdr : 无法将“herdr”项识别为 cmdlet...

通常是当前 PowerShell 还没有重新加载新的 PATH。

重新打开一个 PowerShell 后再执行即可。

六、macOS 安装 Herdr

macOS 安装 Herdr 更简单，而且目前属于 Herdr 官方稳定支持的平台。

方法一：官方安装脚本

打开 Terminal：

bash 复制代码

curl -fsSL https://herdr.dev/install.sh | sh

安装完成后执行：

bash 复制代码

herdr --version

然后启动：

bash 复制代码

herdr

方法二：Homebrew 安装

如果 Mac 已经安装 Homebrew，我更推荐这种方式：

bash 复制代码

brew install herdr

安装完成：

bash 复制代码

herdr

即可启动。

需要注意，如果使用 Homebrew 安装 Herdr，以后升级也应该使用 Homebrew：

bash 复制代码

brew upgrade herdr

而不是：

bash 复制代码

herdr update

Herdr 官方说明，herdr update 主要用于官方安装脚本安装的版本，Homebrew、mise 和 Nix 安装应继续通过对应包管理器更新。

七、Windows 安装 Oh My Pi

打开 PowerShell：

powershell 复制代码

irm https://omp.sh/install.ps1 | iex

安装完成后：

powershell 复制代码

omp

即可启动 Oh My Pi。

OMP 当前提供 Windows 原生版本，不要求通过 WSL 运行。

八、macOS 安装 Oh My Pi

macOS 有两种比较方便的安装方法。

方法一：官方脚本

Terminal 执行：

bash 复制代码

curl -fsSL https://omp.sh/install | sh

安装完成后：

bash 复制代码

omp

方法二：Homebrew

如果已经安装 Homebrew：

bash 复制代码

brew install can1357/tap/omp

然后：

bash 复制代码

omp

即可启动。

OMP 官方目前同时支持 macOS、Linux 和 Windows。

九、让 Herdr 集成 Pi

这里是 Herdr + Pi 真正重要的一步。

如果使用的是原版 Pi：

bash 复制代码

herdr integration install pi

查看 Integration 状态：

bash 复制代码

herdr integration status

Herdr 会安装 Pi 的 Integration：

text 复制代码

~/.pi/agent/extensions/herdr-agent-state.ts

这个扩展可以让 Pi 主动向 Herdr 报告：

text 复制代码

Agent 状态
Session 信息

从而让 Herdr 更准确地知道 Pi 当前是在工作、空闲还是等待用户处理。

十、让 Herdr 集成 Oh My Pi

如果使用：

bash 复制代码

omp

那么应该安装 OMP Integration：

bash 复制代码

herdr integration install omp

而不是：

bash 复制代码

herdr integration install pi

安装完成后检查：

bash 复制代码

herdr integration status

OMP 的 Herdr 扩展默认位于：

text 复制代码

~/.omp/agent/extensions/herdr-omp-agent-state.ts

OMP Integration 会向 Herdr 报告：

text 复制代码

omp Agent
生命周期状态
Session Identity

Herdr 还可以根据保存的 Session，在恢复时使用类似：

bash 复制代码

omp --resume=<session>

的方式恢复 OMP 会话。

因此记住：

text 复制代码

Pi：

herdr integration install pi
pi

和：

text 复制代码

Oh My Pi：

herdr integration install omp
omp

十一、在 Herdr 中使用 Oh My Pi

安装好以后，使用起来其实非常简单。

例如项目：

text 复制代码

~/Projects/my-project

首先进入项目目录。

macOS：

bash 复制代码

cd ~/Projects/my-project

Windows：

powershell 复制代码

cd D:\project\my-project

然后启动 Herdr：

bash 复制代码

herdr

进入 Herdr 后，Pane 本质上就是一个正常终端。

直接输入：

bash 复制代码

omp

即可。

运行关系：

text 复制代码

Terminal
   │
   ▼
 Herdr
   │
   ▼
  OMP
   │
   ▼
 AI Model

到这里 Herdr + OMP 就已经可以正常使用了。

十二、Herdr 真正好用的地方：同时运行多个 Agent

如果只运行一个：

bash 复制代码

omp

其实直接用系统 Terminal 也没有问题。

Herdr 真正的价值是在：

同时运行多个 Agent。

例如开发一个前后端项目：

text 复制代码

Herdr
│
├── Pane 1
│   └── omp
│       └── 前端开发
│
├── Pane 2
│   └── omp
│       └── 后端开发
│
├── Pane 3
│   └── codex
│       └── Code Review
│
└── Pane 4
    └── npm run dev

第一个 OMP：

text 复制代码

帮我负责 frontend 目录。

完成登录页面以及用户信息页面，
不要修改 backend。

第二个 OMP：

text 复制代码

负责 backend。

完成登录接口、JWT 鉴权和用户信息接口，
不要修改 frontend。

Codex：

text 复制代码

Review 当前 Git diff，检查前后端实现有没有明显问题。

最后一个普通终端：

bash 复制代码

npm run dev

这样就形成了一个非常简单的：

text 复制代码

Multi-Agent Coding Environment

十三、一个 Herdr 里不一定只能运行 OMP

Herdr 本身支持很多 Coding Agent。

例如：

text 复制代码

Herdr
│
├── OMP
│
├── Pi
│
├── Claude Code
│
├── Codex
│
├── OpenCode
│
└── npm run dev

Herdr 当前官方 Integration 列表已经包含 Pi、OMP、Claude Code、Codex、Copilot CLI、OpenCode、Hermes Agent、Grok CLI 等多种 Agent。

所以完全可以按照不同 Agent 的特点进行分工。

例如：

text 复制代码

OMP
↓
主要功能开发

Codex
↓
Code Review

Claude Code
↓
架构分析

Terminal
↓
运行项目

十四、为什么不用普通 Terminal？

假设平时开发需要：

text 复制代码

终端 1：OMP
终端 2：OMP
终端 3：Codex
终端 4：npm run dev
终端 5：查看日志

普通开发方式就是：

text 复制代码

Windows Terminal
Windows Terminal
Windows Terminal
...

或者 Mac：

text 复制代码

Terminal
Terminal
Terminal
...

Herdr 则可以变成：

text 复制代码

                    Herdr
                      │
       ┌──────────────┼──────────────┐
       │              │              │
       ▼              ▼              ▼
      OMP           Codex        Dev Server
       │              │              │
       ▼              ▼              ▼
     写代码          Review          跑项目

所有任务都集中在一个 Workspace 中。

这也是 Herdr 最大的使用价值。

十五、Herdr Session 为什么很重要？

Herdr 并不是简单地把几个终端画在一个窗口里。

它还有一个很重要的能力：

Session 持久化。

也就是说，你可以离开 Herdr，但后台的 Session 继续存在。

重新执行：

bash 复制代码

herdr

可以再次进入之前的工作环境。

对于已经安装 Integration 的部分 Agent，Herdr 还能保存对应的 Agent Session Identity，并在 Herdr Session 恢复时恢复 Agent 会话。Pi 和 OMP 都支持这种原生 Session 恢复机制。

这对于长时间执行的 Coding Agent 非常有用。

十六、如何真正关闭 Herdr？

需要注意：

text 复制代码

退出 Herdr 界面

和：

text 复制代码

停止 Herdr Session

不是一回事。

如果想真正停止默认 Herdr Server：

bash 复制代码

herdr server stop

然后再次：

bash 复制代码

herdr

就会重新启动。

Herdr 官方也特别说明，停止 Server 会同时退出对应 Pane 中运行的进程。

所以如果里面有：

text 复制代码

omp
npm run dev

也会一起停止。

十七、推荐使用流程

如果使用的是 macOS：

bash 复制代码

# 安装 Herdr
brew install herdr

# 安装 OMP
brew install can1357/tap/omp

# 安装 Herdr OMP Integration
herdr integration install omp

# 查看 Integration
herdr integration status

# 进入项目
cd ~/Projects/my-project

# 启动 Herdr
herdr

# 在 Herdr Pane 中运行
omp

Windows：

powershell 复制代码

# 安装 Herdr
powershell -ExecutionPolicy Bypass -c "irm https://herdr.dev/install.ps1 | iex"

# 安装 OMP
irm https://omp.sh/install.ps1 | iex

# 安装 Integration
herdr integration install omp

# 查看 Integration
herdr integration status

# 进入项目
cd D:\project\my-project

# 启动
herdr

# Herdr 中运行
omp

如果以后不需要 Herdr 继续运行：

bash 复制代码

herdr server stop

十八、Herdr + OMP 到底解决了什么问题？

单独使用 OMP：

text 复制代码

你
│
▼
OMP
│
▼
代码

使用 Herdr 后：

text 复制代码

                    你
                    │
                    ▼
                  Herdr
                    │
        ┌───────────┼───────────┐
        │           │           │
        ▼           ▼           ▼
       OMP         OMP        Codex
        │           │           │
        ▼           ▼           ▼
      Frontend    Backend      Review

原本：

一个 AI Agent 顺序完成所有任务。

逐渐变成：

多个 AI Agent 同时处理不同任务。

因此，我更愿意把这套组合理解成：

OMP 是 AI 程序员，而 Herdr 是 AI 程序员工作的办公室。

如果平时只偶尔使用一次 AI Coding Agent，Herdr 的作用可能并不明显。

但当你的工作流开始变成：

text 复制代码

一个 Agent 写前端
一个 Agent 写后端
一个 Agent Review
一个终端运行项目
一个终端查看日志

Herdr 的优势就会非常明显。

尤其是对于已经开始使用 Pi、OMP、Claude Code、Codex 等终端 Agent 的开发者来说，Herdr 值得尝试。

转载：转载请注明原文链接 - Herdr + Oh My Pi：我的多 AI Agent 编程工作流

0/50

暂无评论，快来抢沙发吧~

一、Herdr 是什么？

二、Pi 是什么？

三、Oh My Pi 又是什么？

四、Herdr 和 Pi 到底是什么关系？

五、Windows 安装 Herdr

六、macOS 安装 Herdr

方法一：官方安装脚本

方法二：Homebrew 安装

七、Windows 安装 Oh My Pi

八、macOS 安装 Oh My Pi

方法一：官方脚本

方法二：Homebrew

九、让 Herdr 集成 Pi

十、让 Herdr 集成 Oh My Pi

十一、在 Herdr 中使用 Oh My Pi

十二、Herdr 真正好用的地方：同时运行多个 Agent

十三、一个 Herdr 里不一定只能运行 OMP

十四、为什么不用普通 Terminal？

十五、Herdr Session 为什么很重要？

十六、如何真正关闭 Herdr？

十七、推荐使用流程

十八、Herdr + OMP 到底解决了什么问题？

评论 (0)