herdr 教學：
讓 AI Coding Agent 關掉視窗也不停工的終端機工作台

用過 Claude Code 或 Codex 這類 AI coding agent 的人，大概都碰過這個尷尬時刻：任務跑到一半，你得闔上筆電去開會，回來發現 agent 早就斷了，工作重來。或者同時開了四、五個終端機視窗跑不同專案的 agent，想知道哪一個卡住在等你回答，只能一個一個視窗點過去看。

herdr 就是為這兩個痛點做的工具。它是一個開源的終端機工作台（GitHub 兩萬五千顆星以上，Apache 2.0 授權），把所有 agent 的終端機收進一個常駐背景的伺服器裡：你關掉視窗、斷線、換一台裝置，agent 都繼續跑；側邊欄還會即時標出每個 agent 是在工作、卡住等回覆，還是已經做完。

一、herdr 是什麼

官方的一句話介紹是「the runtime your coding agents live on」，你的 coding agent 住在上面的執行環境。用熟悉的東西類比：它像 tmux 這類終端機多工器（multiplexer）的現代版，但從頭就是為「同時管理多個 AI agent」設計的。

幾個和傳統多工器不一樣的地方：

• Agent 狀態一目瞭然：herdr 會自動辨識窗格裡跑的是哪個 agent，並在側邊欄標出 working（工作中）、blocked（卡住等你回覆）、done（做完了）、idle（閒置）。不用再逐一翻視窗找那個在等你按同意的傢伙。
• 不包裝、不取代：Claude Code、Codex、Cursor CLI 這些工具照常執行，herdr 只是接管它們的終端機。你原本的用法完全不變。
• 滑鼠和鍵盤都是一等公民：可以像 tmux 一樣用 ctrl+b 前綴鍵操作，也可以直接點擊、拖曳分割、右鍵選單。對沒用過 tmux 的人友善很多。
• Agent 之間可以互相指揮：herdr 提供 CLI 和 socket API，agent 可以開新窗格、對另一個 agent 下指令、等待對方真正卡住再介入。
• 單一 Rust 執行檔：不是 Electron 應用程式，就在你原本的終端機裡跑，輕量。

二、它怎麼做到「關掉也不停工」

關鍵在架構：herdr 分成「伺服器」和「客戶端」兩層。你看到的終端機畫面只是客戶端，真正執行 agent 的窗格全部活在背景的伺服器行程裡。關掉終端機視窗只是客戶端離開（detach），伺服器和裡面的 agent 照跑；之後在任何終端機再打一次 herdr，就接回（reattach）原本的工作現場，連捲動歷史都在。

這裡要把話說得精確一點。herdr 解決的是 agent 的存活綁在「那個開著的視窗」上的問題：關視窗、斷線、當機重開後 session 都救得回來。但如果筆電闔蓋進入睡眠，本機的程序還是會暫停，這是作業系統的行為，任何工具都繞不過。想做到真正的「闔蓋走人、agent 照跑」，做法是把 herdr 跑在一台不會睡的機器上（雲端 VPS 或家裡常開的主機），人在哪裡都用 SSH 接回去，第六節會講這個用法。

三、安裝

herdr 是單一執行檔，安裝很快。macOS 和 Linux 用官方安裝腳本：

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

已經在用 Homebrew 或 mise 的話，也可以：

brew install herdr        # Homebrew
mise use -g herdr         # mise

Windows 用 PowerShell：

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

之後的版本更新：官方安裝腳本裝的用 herdr update；Homebrew、mise 裝的走各自套件管理器的更新指令。

四、快速上手：五分鐘走一遍

1. 在專案目錄啟動：cd 到你的專案，執行 herdr。它會自動啟動（或接上）背景伺服器，並開好一個工作區，你不需要管 socket 或 session 名稱。
2. 照常啟動你的 agent：在窗格裡直接打 claude、codex 或其他工具。herdr 會自動偵測出這是一個 agent，側邊欄開始顯示它的狀態。
3. 分割窗格、多開幾個：右鍵選單可以分割窗格、開新分頁，或用 ctrl+b 再按 v（右分割）、-（下分割）。每個窗格都是一個真實的終端機，可以各跑一個 agent。
4. 離開：按 ctrl+b 再按 q，或乾脆直接關掉終端機視窗。所有 agent 繼續執行。
5. 回來：任何時候打開終端機執行 herdr，整個工作現場原樣接回。看一眼側邊欄，哪個 agent 標成 blocked 就先去處理哪個。

滑鼠操作值得特別一提：點擊切換窗格、拖曳邊框調大小、框選文字就自動複製（不用按 Ctrl+C）、雙擊單字直接複製。沒用過終端機多工器的人可以完全靠滑鼠活下來，之後再慢慢學快捷鍵。

五、核心觀念：工作區、分頁、窗格、Agent 狀態

herdr 的畫面結構是三層：工作區（workspace）是最上層的專案容器，一個 repo 或一個任務開一個；工作區裡有分頁（tab），用來分「agents」「logs」「server」這類不同視角；分頁裡是窗格（pane），每個窗格就是一個真實終端機。

Agent 的五種狀態，看懂它們就看懂了 herdr 的價值：

狀態偵測是自動的：herdr 認得各家 agent 的畫面特徵（偵測規則還會從官方遠端更新），部分工具裝了整合掛勾後判斷會更準。當某個窗格狀態顯示不對，可以用 herdr agent explain 查它是怎麼判斷的。

六、進階：遠端伺服器與手機接管

前面說過，想要真正的「闔蓋走人、agent 照跑」，就把 herdr 跑在一台不會關的機器上。做法沒有任何新東西，就是 SSH：

ssh you@server    # 連上跑 agent 的機器
herdr             # 在遠端啟動或接回 herdr

此時 agent、窗格、herdr 伺服器全部在遠端機器上。你斷線、換咖啡廳、換電腦，再 SSH 上去打 herdr 就回到現場。程式碼和 API 金鑰也都留在那台機器上，筆電丟了都不影響工作進度。

手機也一樣：裝任何一個 SSH 客戶端 App（iPhone 上官方推薦 moshi 這類工具），連上伺服器打 herdr。它的介面會自動適應窄螢幕，躺在沙發上就能看哪個 agent 卡住、回它一句話讓它繼續跑。不需要另外的手機 App 或網頁後台。

七、支援哪些 Agent

herdr 內建自動偵測的 agent 有二十多個，常見的都在列：Claude Code、Codex、Cursor Agent CLI、OpenCode、GitHub Copilot CLI、Grok CLI、Qwen Code、Devin CLI、Amp、Kilo Code、Droid、Kiro CLI 等；Gemini CLI 和 Cline 也能偵測，只是測試較少。清單以官方文件的 Supported agents 頁為準，更新得很勤。

不在清單上的工具也照常能跑，只是側邊欄可能拿不到精細的狀態，必要時可以自己寫偵測規則（TOML 格式的 manifest 放在 ~/.config/herdr/agent-detection/），或讓工具透過 socket API 主動回報狀態。

八、常用指令與快捷鍵速查

九、使用前該知道的幾件事

• 完全免費開源：Apache 2.0 授權，程式碼在 GitHub 公開，商用沒有限制。開發團隊是 Y Combinator 支持的新創，專案更新非常頻繁。
• 本機睡眠照樣會暫停：herdr 救的是「視窗關掉、連線斷掉、當機重開」，救不了作業系統的睡眠。闔蓋不停工請走第六節的遠端做法，或把電腦設成闔蓋不睡眠。
• Windows 支援較新：Windows 版起步比 macOS、Linux 晚，官方文件另有 Windows 頁面，遇到問題先查那裡。
• tmux 使用者無痛轉移：預設前綴鍵同樣是 ctrl+b，概念幾乎對得上，多出來的是 agent 狀態、滑鼠操作和 socket API。
• agent 還是各自算各自的錢：herdr 只管終端機和狀態，Claude Code、Codex 的訂閱或 API 費用照常，跑整晚前先想一下額度。

十、重點整理

• herdr 是為 AI coding agent 設計的開源終端機工作台：agent 活在常駐背景的伺服器裡，關視窗、斷線都不中斷，隨時隨地接回現場。
• 側邊欄即時標出每個 agent 是 working、blocked、done 還是 idle，多專案多 agent 也不用逐一翻視窗。
• 安裝一行指令，啟動就打 herdr，agent 照原本的方式跑，零改造。
• 想要闔蓋走人也不停工，把 herdr 跑在雲端或常開的機器上，用 SSH（包括手機）接回去。
• Apache 2.0 開源免費，支援 Claude Code、Codex、Cursor 等二十多種 agent。