Personal Knowledge Base

修哥筆記

「知識的沉澱與分享」

技術隨筆

Herdr 是什麼？為 AI Coding Agent 而生的終端工作區管理器（與 tmux 的差別）

· #Herdr #tmux #AI Agent #終端機 #Omarchy #技術隨筆

一、一句話認識 Herdr

「the runtime your coding agents live on」——AI coding agent 的執行環境。它不是另一個 AI 工具，而是讓你的 agent 住進去的終端工作區管理器（terminal workspace manager），概念上像「tmux，但為 agent 而生」。

  • GitHub：herdrdev/herdr（Apache-2.0 授權）
  • Rust 單一二進制，沒有 Electron，跑在你原本就在用的終端機裡
  • 它不包裝、也不取代任何 agent：Claude Code、Codex、Cursor、OpenCode、Pi、Grok 等照常使用，Herdr 只是「擁有」它們的終端機並加以管理

二、核心模型：Workspace → Tab → Pane → Agent

Herdr 的組織方式是四層：

  • Workspace：專案級容器。每個進行中的專案給一個 workspace，sidebar 裡的 agent 狀態才看得清楚
  • Tab：workspace 內的分頁
  • Pane：tab 內的分割區塊（每個 pane 可以跑一個 agent）
  • Agent：pane 裡跑的 coding agent——Herdr 會自動偵測

三、殺手級特性

1. Detach 不中斷工作

關掉終端機視窗、斷開 SSH，Herdr server 與所有 agent 繼續在背景跑。重新在專案目錄執行 herdr 就接回原本的 session。機器重啟後，Herdr 會恢復儲存的佈局，並可 resume 支援的 agent session（官方註明：原始 process 本身不會存活）。

2. 永遠知道誰在等你（agent 狀態）

sidebar 會標示每個 agent 的狀態：working（工作中）、blocked（卡住等你）、done（完成）、idle（閒置）。多專案並行時，不用一個個 pane 翻找「到底是哪個在等我回答」。

3. 多機一窗

本地工作與多台已儲存的 SSH 機器放在同一個視窗，agent 清單合併顯示、各自獨立重連。

4. Agent-native（agent 可以驅動 Herdr）

agent 透過 CLI 與 socket API 操作 Herdr：開 pane、互相 prompt、等待另一個 agent 真正進入 blocked 狀態。這是「多 agent 協作」的基礎建設。

5. 滑鼠與鍵盤都是一等公民

  • 滑鼠：點擊聚焦 pane/tab/workspace/agent、拖曳邊界調整大小、右鍵選單（分割/開 tab）、拖曳選取即複製（不需 Ctrl+C）、雙擊 token 直接複製、Ctrl-click 開連結
  • 鍵盤：tmux 風格的 prefix 模式，也支援完全不用 prefix 的設定

常用鍵位（prefix 預設 Ctrl + b；Omarchy 內建配置改成 Ctrl + Space）：

動作 鍵位
向右分割 prefix + v
向下分割 prefix + -
新分頁 prefix + c
上/下一個分頁 prefix + n / prefix + p
Workspace 導覽 prefix + w
新增 workspace prefix + Shift + n
Detach（脫離） prefix + q
顯示所有鍵位 prefix + ?

6. 插件與擴充

有插件市場可擴充 pane 與工作流程，另有 integrations、socket API 供外部工具串接。

四、安裝與快速開始

# 一行安裝
curl -fsSL https://herdr.dev/install.sh | sh

# 或用套件管理器
brew install herdr
mise use -g herdr

然後在專案目錄直接啟動：

herdr          # 啟動或接回預設背景 session
claude         # 在某個 pane 裡啟動你的 agent（或 codex / opencode / pi…）
  • 不需要管理 socket，herdr 會自動處理
  • 脫離：prefix + q 或直接關窗；回來：再執行 herdr
  • 真正結束：herdr server stop

五、與 tmux 的差別

面向 Herdr tmux
定位 專為 AI coding agent 設計的執行環境 通用 terminal multiplexer
Agent 概念 一等公民（狀態、偵測、協作、API） 完全沒有
佈局持久化 重啟可恢復佈局、可 resume agent session server 重啟後 session 常消失（需靠插件）
多機整合 內建（本地＋SSH 同一視窗） 本機為主，多機要自行處理
pane 狀態 working／blocked／done／idle 語意標記 純文字、無語意
滑鼠支援 一等公民（點擊、拖曳、複製） 需開啟且功能較弱
實作 Rust 單一二進制 C、POSIX、極輕量
生態 較新、插件市場起步 極成熟、TPM 與大量腳本、幾乎處處都有

六、優缺點總結

優點

  1. 為 AI 工作流量身打造：多 agent 並行、狀態一目瞭然、agent 能互相等待與協作
  2. 斷線與重啟不中斷：SSH 掉了工作照跑，回來無縫接續
  3. 多機一窗、鍵鼠雙棲、插件擴充、Rust 高效（無 Electron 負擔）

缺點

  1. 較新：生態、文件、穩定性比不上 tmux 十多年的淬鍊
  2. 不用 coding agent 就顯得多餘：核心價值建立在「同時跑多個 AI agent」，單純終端多工反而多一層複雜度
  3. 重啟後原始 process 不存活：能恢復的是佈局與可 resume 的 agent session
  4. 需另行安裝，對只想「開視窗分頁」的人來說是較重的方案

七、怎麼選？

  • 你經常同時跑多個 coding agent、希望它們能協作、斷線也能續跑 → Herdr
  • 你要的是跨環境通用、極穩、純文字的終端多工（不綁 agent）→ tmux 依然是王者

值得一提的是：Omarchy 兩個都內建——Super + Alt + Return 開 tmux、Super + Ctrl + Return 開 Herdr，Super + Ctrl + K 可看 Herdr 全部鍵位。兩者並存、各取所需。

資料來源：Herdr 官方 README 與文件（herdr.dev，GitHub herdrdev/herdr）、Omarchy 手冊 manual/21-tuis.md

← 返回首頁