結論
herdr は、Claude Code・Codex などの AI コーディングエージェントを1つのターミナルの中に並べて動かし、それぞれが「作業中」「入力待ち」「完了」のどれかをサイドバーで見分けられるオープンソースのツールです。macOS・Linux は curl -fsSL https://herdr.dev/install.sh | sh か brew install herdr で入れ、herdr で起動します。
この記事でわかること
- herdr のインストール・起動・デタッチと、既定のキー操作の一覧
- 複数のエージェントを並べる手順と、状態(blocked・working・done・idle)の読み方
- tmux との違いの表と、手元で動かした tmux・設定チェッカーの実物
herdr は、ふだんのターミナルの中で動く1つのプログラムです。裏のサーバーがペイン(区切られた1つ1つの端末)を持ち続けるので、画面を閉じてもエージェントは止まりません。
flowchart TD
C[ターミナルの画面<br>herdr のクライアント] -->|herdr で接続| S[herdr のサーバー<br>裏で動き続ける]
S --> W1[ワークスペース<br>プロジェクトごと]
W1 --> T1[タブ]
T1 --> P1[ペイン<br>claude・codex・テスト]
S --> SB[サイドバー<br>状態を集めて表示]
よく調べられることの答えを先にまとめます。
| 知りたいこと | 答え | 詳しい節 |
|---|---|---|
| herdrとは | AI エージェントを1つのターミナルに並べ、状態を見分けるツール(Apache 2.0) | herdrとは |
| herdr インストール | install.sh・Homebrew・mise・Nix・手動。Windows は PowerShell | herdrのインストール |
| herdr 使い方(起動) | プロジェクトのフォルダーで herdr。抜けるのは ctrl+b q |
起動・デタッチ・終了 |
| キー操作 | プレフィックス ctrl+b のあとに1文字。一覧は ctrl+b ? |
キー操作一覧 |
| エージェントを並べる | ペインを分けて claude・codex などを起動すると自動で見分ける | 複数のAIエージェントを並べる |
| 設定ファイル | ~/.config/herdr/config.toml(TOML) |
設定ファイル |
| tmux との違い | tmux は汎用の端末の分割。herdr はエージェントの状態の表示と操作の API を持つ | tmuxとの違い |
| 料金 | 無料・オープンソース(公式の記載) | herdrとは |
| Windows で使えるか | 使える。公式ではベータと表示し、できないことの一覧がある | herdrのインストール |
確認環境:Ubuntu 24.04.5 LTS(x86_64)で公式の https://herdr.dev/install.sh を取得しようとしましたが、この環境のプロキシが herdr.dev への接続を拒否したため、herdr 本体は入れていません(別の入手先・別の方法でも入れていません)。herdr の操作・キー・設定・API・セッションの扱いは、公式ドキュメント(herdr.dev/tui/docs の各ページ)・公式サイト・公式 GitHub(herdrdev/herdr。Latest は v0.9.5)で確かめた記載だけで書いています。手元で動かしたのは、tmux 3.4(自分専用のソケット)、git 2.43.0 の worktree、Python 3.13.18 で作った設定ファイルのキー重複チェッカーと数値の計算です。AI のモデルを呼ぶ操作はしていません。図は mermaid で描画を確かめました(確認日 2026年11月18日)。
本記事の内容は、ご自由にお使いください。
ご利用の際は、出典として本ページへのリンクを記載いただけますようお願いします。
(記載例)出典:株式会社RJC「herdrとは|AIエージェントを並べて動かす使い方・キー一覧・tmuxとの違い」
herdrとは(できること・アプリ版とTUI版)
この節では、herdr が何をするツールなのかと、名前の似た2つの製品の違いが分かります。
herdr は、公式 GitHub で「the runtime your coding agents live on(コーディングエージェントが動く土台)」と説明されている、Rust で書かれた1つの実行ファイルです。裏で動くサーバーが端末を開いたまま持ち続け、各ペインのエージェントを working(作業中)・blocked(入力待ち)・idle(待機)などに分けて表示し、エージェント自身が CLI とソケット API で herdr を操作できます。ライセンスは Apache License 2.0 で、公式サイトは無料と書いています。
アプリ版(Herdr)とターミナル版(Herdr TUI)は別物
2026年11月18日時点の公式サイトには、2つの製品があります。この記事で扱うのは、ターミナルの中で動くherdr(Herdr TUI)です。
Herdr TUI(この記事)
ふだんのターミナルの中で動く。コマンドは herdr
GitHub は herdrdev/herdr。設定は ~/.config/herdr
macOS・Linux・Windows(ベータ)
Herdr(アプリ版)
ネイティブのデスクトップアプリ。裏で herdr-core が動く
GitHub は herdrdev/herdr-app。設定は ~/.config/herdr-app
macOS(Apple シリコン)・Linux・Windows、スマホのアプリもある
見分けられるエージェント
公式サイトのトップは「22種のエージェントの CLI を最初から見分ける」と書いています。Agents のページで連携の名前が載っているのは、Claude Code(claude)・Codex(codex)・GitHub Copilot CLI(copilot)・Cursor Agent CLI(cursor)・OpenCode(opencode)・Pi・Droid・Devin CLI・Qwen Code・Grok CLI などです。一覧にないエージェントも動きますが、状態の表示がない端末として扱われます。
herdrのインストール(macOS・Linux・Windows)
この節では、公式の Install のページにある入れ方と、更新・版の切り替えのコマンドが分かります。
macOS と Linux は1行のインストールスクリプト、Homebrew、mise のどれかで入れます。公式の配布物は Linux(x86_64・aarch64)、macOS(Intel・Apple シリコン)、Windows(x86_64)の5種類です。
| 方法 | コマンド(公式の記載) | 更新のしかた |
|---|---|---|
| スクリプト(macOS・Linux) | curl -fsSL https://herdr.dev/install.sh | sh | herdr update |
| Homebrew | brew install herdr | Homebrew で更新 |
| mise | mise use -g herdr | mise で更新 |
| Nix | nix profile install github:herdrdev/herdr/v0.x.y | Nix で更新 |
| Windows(PowerShell) | 下のコード参照 | herdr update |
| 手動 | GitHub Releases から実行ファイルを取得 | 取り直す |
Windows は、公式の Herdr TUI のページに載っている次の PowerShell のコマンドで入れます。会社の PC でスクリプトの実行が止められる場合は、その設定を変えずに、所属先の管理者の案内に従います(公式は GitHub Releases の zip の配布もしています)。
irm https://herdr.dev/install.ps1 | iex
手動で入れる場合、Linux・macOS は実行の権限を付けて PATH の通った場所へ置きます。Windows の zip には herdr.exe と ConPTY の実行環境が入っていて、公式は「展開したフォルダーをそのまま保つ(exe だけを取り出さない)」と書いています。
chmod +x herdr-linux-x86_64
mv herdr-linux-x86_64 ~/.local/bin/herdr
入れる
上の表のどれか1つの方法で入れる。スクリプトはパイプで sh に渡すので、気になる場合は先に中身を開いて読む。
起動して確かめる
ターミナルで herdr を実行する。「command not found」なら、ターミナルを開き直すか、入れた場所が PATH に入っているかを確かめる(公式の記載)。
更新する
スクリプトで入れたなら herdr update。Homebrew・mise・Nix で入れたなら、そのパッケージマネージャーで更新する。herdr update は動いているサーバーを止めないので、herdr を起動し直すと新しい版につながる。
公式の Install のページには、アンインストールの手順は載っていません(2026年11月18日時点)。
Windows は ConPTY で動き、herdr terminal attach やサーバーの引き継ぎは使えない、日本語入力の候補の窓がずれることがある、などの違いが公式の Windows のページにまとまっています。
herdrの起動・デタッチ・終了と画面の構成
この節では、herdr の起動から抜け方・終わり方までと、ワークスペース・タブ・ペインの関係が分かります。
作業したいプロジェクトのフォルダーで herdr を実行すると、既定のセッションが起動し(すでにあれば接続し)、ワークスペースが1つ自動で作られます。ソケットを自分で管理する手間はありません。
cd ~/project
herdr # 起動(すでに動いていれば接続し直す)
# ctrl+b を押してから q → デタッチ(エージェントは動き続ける)
herdr # 同じセッションへ戻る
herdr server stop # セッションを終わらせ、ペインのプロセスも止める
画面は、上から順に次の入れ子です(公式の Concepts のページの説明)。
| 単位 | 役割 | 使い分けの例 |
|---|---|---|
| サーバー | ペインとプロセスの状態を持ち、裏で動き続ける | セッションごとに1つ |
| ワークスペース | いちばん上の入れ物。サイドバーに状態が出る | リポジトリ・課題ごとに1つ |
| タブ | ワークスペースの中の画面の並び | エージェント用・ログ用・サーバー用 |
| ペイン | 本物の端末1つ。右・下に分けられる | claude を1つ、テストを1つ |
herdr はマウスで操作できるように作られています。ペイン・タブ・ワークスペースはクリックで選び、境目をドラッグして大きさを変え、右クリックのメニューからペインの分割やタブの追加ができます。
herdrのキー操作一覧(プレフィックス ctrl+b)
この節では、herdr の既定のキー操作と、モードの考え方が分かります。
ctrl+b(プレフィックス)を押して離し、続けて1つのキーを押すと herdr の操作になります。tmux と同じ押し方です。今の設定で使えるキーは ctrl+b ? のヘルプにすべて出ます。表は公式の Config reference にある既定値です。
| 操作 | 既定のキー | 設定の名前 |
|---|---|---|
| 右に分割 | prefix+v | split_vertical |
| 下に分割 | prefix+minus(ctrl+b のあと -) | split_horizontal |
| ペインを閉じる | prefix+x | close_pane |
| ペインの移動(左・下・上・右) | prefix+h・j・k・l | focus_pane_left など |
| 1つのペインを全画面 | prefix+z | zoom |
| 新しいタブ | prefix+c | new_tab |
| 次・前のタブ | prefix+n・prefix+p | next_tab・previous_tab |
| タブへ番号で移動 | prefix+1〜9 | switch_tab |
| 新しいワークスペース | prefix+shift+n | new_workspace |
| ワークスペースを選ぶ | prefix+w | workspace_picker |
| 新しい worktree | prefix+shift+g | new_worktree |
| コピーモード | prefix+[ | copy_mode |
| 設定の読み直し | prefix+shift+r | reload_config |
| デタッチ | prefix+q | detach |
| ヘルプ(キーの一覧) | prefix+? | help |
公式の Concepts は、キーをペインへそのまま送る「ターミナルモード」、herdr の操作を1つ待つ「プレフィックスモード」、ワークスペースを移動する「ナビゲートモード」の3つで説明しています。
複数のAIエージェントを並べて動かす使い方
この節では、herdr で複数のエージェントを並べる手順と、同じリポジトリで並べるときの注意が分かります。
ペインを分けて、それぞれで claude・codex・opencode などをいつもどおり起動するだけで、herdr はエージェントを自動で見分けます。エージェントを包んで動かすのではなく、herdr の端末の中でそのまま動かす作りです。
- 1プロジェクトのフォルダーで herdr を起動するワークスペースが1つできる。別のリポジトリは prefix+shift+n で別のワークスペースにする
- 2prefix+v・prefix+minus でペインを分ける右クリックのメニューでも分けられる
- 3各ペインでエージェントを起動するclaude・codex など。herdr が見分けてサイドバーに出す
- 4連携を入れる(任意)
herdr integration install claudeなどで、サーバーを起動し直してもセッションに戻れるようにする - 5サイドバーで blocked を探して答えるprefix+o で通知の出たペインへ移れる
同じリポジトリで並べるなら worktree で分ける
herdr はファイルやネットワークをエージェントごとに分けません。同じフォルダーで2つのエージェントが同じファイルを書き換えると、ぶつかります。herdr には worktree を作るキー(prefix+shift+g)があり、作る場所の既定は ~/.herdr/worktrees です。worktree 自体は git の機能なので、手元の git 2.43.0 で、エージェントごとに作業フォルダーを分けた結果を載せます。
$ git worktree add -q ../wt/agent-a -b agent-a
$ git worktree add -q ../wt/agent-b -b agent-b
$ git worktree list
/dev/shm/t629/app dc55d63 [main]
/dev/shm/t629/wt/agent-a dc55d63 [agent-a]
/dev/shm/t629/wt/agent-b dc55d63 [agent-b]
フォルダーとブランチが別になるので、同じファイルを同時に書き換えることがありません。worktree のコマンドは関連記事「git worktreeの使い方|ブランチを同時に開く手順とコマンド早見表」で、Claude Code で並べるときの衝突の防ぎ方は関連記事「Claude Code×git worktree並列開発|設定例と衝突対策表」で扱っています。
1つのセッションの中で仕事を任せる方法(サブエージェント)は関連記事「Claude Codeサブエージェントの使い方|実測で見る委任とコンテキスト節約」で扱っています。
エージェントの状態表示(blocked・working・done・idle)
この節では、サイドバーに出る状態の意味と、状態がずれたときの確かめ方が分かります。
いちばん見るべきなのは blocked(入力待ち)です。承認・質問・権限の確認で止まっているエージェントで、答えるまで先へ進みません。
| 状態 | 意味(公式の Concepts) | すること |
|---|---|---|
| blocked | 入力・承認・判断を待っている | そのペインを開いて内容を読み、答える |
| working | 作業中 | 待つ |
| done | 終わったが、まだ見ていない | 結果を見る(見ると idle になる) |
| idle | 終わったか待っていて、すでに見た | 次の指示を出す |
| unknown | herdr が自信をもって分けられない | ペインを直接見る |
公式の Agents のページによると、herdr はペインの中のエージェントのプロセスを見つけ、画面のいちばん下(さかのぼった部分ではない)を読んで状態を決めます。連携やエージェント自身が状態を知らせる場合は、その知らせを使います。blocked は厳しめに決められていて、知られている承認・質問の画面に合うときだけ blocked になり、合わないときは idle に戻ります。サイドバーは状態をまとめて表示し、1つのエージェントが blocked なら、そのペイン・タブ・ワークスペースも blocked として表示されます。
idle の表示だけを見て、自動で入力を送る
herdr agent explain で判定の理由を確かめてから送る公式は「idle は許可を意味しない」と書いている
状態がおかしいときは、herdr agent explain <対象> で判定の理由を表示できます。判定の規則(検出マニフェスト)は herdr に同梱され、herdr.dev から自動で更新されます。自動の更新を止めるときは、設定の [update] に manifest_check = false を書きます。
herdrの設定ファイル(config.toml)
この節では、設定ファイルの場所・書き方・反映のしかたと、キーの重複を手元で見つける方法が分かります。
設定ファイルは TOML 形式で、Linux・macOS は ~/.config/herdr/config.toml、Windows は %APPDATA%\herdr\config.toml です。既定の設定の全文は herdr --default-config で表示でき、書き換えたあとは herdr server reload-config(キーなら prefix+shift+r)で反映します。起動時だけ読む項目は、起動し直すと反映されます。
onboarding = false # 初回の案内を出さない
[keys]
prefix = "ctrl+b"
split_vertical = "prefix+v"
clear_pane = "prefix+ctrl+k" # 既定は未設定。公式の例
focus_pane_left = ["prefix+h", "prefix+left"] # 配列で複数のキー
[ui]
sidebar_width = 30 # 既定 26(18〜36)
tab_bar_position = "top"
キーは prefix+n(プレフィックスのあと n)や ctrl+alt+n(直接)のように文字で書き、prefix+1..9 のような番号の範囲も書けます。キーの設定を既定に戻すのは herdr config reset-keys です。公式は、正しくない値は安全な既定値に戻して起動時に警告を出す、と書いています。
キーの重複を手元で見つける(実行結果)
同じキーを2つの操作に割り当てると、どちらが動くかを考える手間が増えます。そこで、TOML を読んでキーの重複を探す約20行のチェッカーを Python 3.13 の標準ライブラリ(tomllib)で作り(prefix+1..9 は9つに展開して数える)、わざと zoom = "prefix+v" を足した設定と、引用符の抜けた設定で動かしました。herdr 本体の判定ではなく、TOML としての読み取りと重複の数え上げです。
== config.toml
prefix = ctrl+b / bindings = 17
DUPLICATE prefix+v -> split_vertical, zoom
== bad.toml
TOMLDecodeError: Invalid value (at line 2, column 10)
prefix = ctrl+b のように引用符を忘れると、TOML として読めない時点で止まります。reload-config の前にこの読み取りを通しておくと、原因を切り分けやすくなります。
覚えておくと役立つ既定値(計算つき)
ログは ~/.config/herdr/ の herdr.log・herdr-client.log・herdr-server.log に出て、自動で切り替わります。
herdrをCLIとソケットAPIで操作する
この節では、コマンドやスクリプト、エージェント自身から herdr を動かす方法が分かります。
herdr は、ワークスペース・タブ・ペイン・エージェントを CLI で操作でき、同じことを Unix ドメインソケット(Windows は名前付きパイプ)の API でもできます。ペインは w1:p1 のような ID で指します。公式の Socket API のページにある例を並べます。
herdr workspace create --cwd ~/project --label api
herdr tab create --label logs
herdr pane split w1:p1 --direction right --ratio 0.333
herdr pane run w1:p2 "npm test"
herdr pane read w1:p2 --source recent --lines 50
herdr agent wait w1:p1 --until blocked
herdr notification show "build failed" --body "api workspace"
herdr api schema --output herdr-api.schema.json
agent wait が待つのはエージェントの状態で、裏で動いているジョブの終わりではありません。ソケットの場所は既定で ~/.config/herdr/herdr.sock、名前付きのセッションは ~/.config/herdr/sessions/<名前>/herdr.sock です。herdr が管理するペインには HERDR_SOCKET_PATH・HERDR_WORKSPACE_ID・HERDR_TAB_ID・HERDR_PANE_ID が入るので、ペインの中のエージェントは自分の場所を知ったうえで操作できます。
やり取りは「1行に1つの JSON」で、要求の id が応答にそのまま返り、成功は result、失敗は error(code と message)に入ります(公式の例:{"id":"req_1","method":"ping","params":{}} に {"id":"req_1","result":{"type":"pong"}})。正確なメソッドの一覧は、手元の herdr で herdr api schema --json を出して確かめるのが確実です。
herdrのセッションの保存と復元・SSHでの接続
この節では、デタッチ・サーバーの再起動・PC の再起動で何が残り何が消えるかと、ほかのマシンをつなぐ方法が分かります。
デタッチ(ctrl+b q)なら、ペインもエージェントもそのまま動き続けます。サーバーが止まると、配置は戻りますが、動いていたプロセスは戻りません。
| 起きたこと | 残るもの | 消えるもの |
|---|---|---|
| デタッチ・画面を閉じた | すべて(ペイン・シェル・エージェント・プロセス) | なし |
| サーバーの停止・再起動 | ワークスペース・タブ・ペインの配置、作業フォルダー、フォーカス | 動いていたシェル・サーバー・テスト |
| 連携を入れたエージェント | エージェントの会話(例:Claude Code は claude --resume で戻る) | そのペインの画面の履歴の再表示 |
| 画面の履歴(既定は無効) | 有効にすると最近の画面の中身を再表示 | 元のプロセス |
画面の履歴の保存は、トークンなどの秘密が画面に出ている可能性があるため既定で無効です。有効にするのは [experimental] の pane_history = true で、保存される session-history.json は端末の履歴と同じように扱うよう公式は書いています。配置は session.json に、控えは session-snapshots/(最大48個、15分に1個まで)に保存されます。
Claude Code の会話に戻るには連携の版 6 以上が要る、と公式にあります。入っている版は herdr integration status で確かめ、以前の版なら herdr integration install <名前> で入れ直します。
SSH でほかのマシンのエージェントも並べる
サーバーや仮想マシンのエージェントも、同じサイドバーに並べられます。前提は、ふだんの ssh workbox でつながることです。
herdr --remote workbox # その場で接続
herdr machine add workbox # 対話で登録(無ければ herdr を入れるか聞かれる)
herdr machine list --json
herdr machine remove <profile-id>
公式によると、herdr は手元のプラグイン・設定・秘密を SSH 先へ写さず、パスワードや秘密鍵も保存しません。認証は OpenSSH に任せます。
herdrとtmuxの違い(比較表と手元の実物)
この節では、herdr と tmux の違いを事実で並べた表と、tmux でエージェントを並べたときの実際の出力が分かります。
tmux は汎用の端末の分割とセッションの保持のツールで、herdr はそれに加えて、エージェントの状態を見分けて表示し、エージェントから操作できる API を持つツールです。どちらが上ということではなく、目的が違います。
| 項目 | herdr | tmux |
|---|---|---|
| プレフィックス | ctrl+b(変えられる) | ctrl+b(変えられる) |
| デタッチ・再接続 | ctrl+b q・herdr | ctrl+b d・tmux attach |
| 単位 | ワークスペース・タブ・ペイン | セッション・ウィンドウ・ペイン |
| エージェントの状態 | 見分けてサイドバーに表示 | 持たない(画面の文字を自分で読む) |
| マウス | 既定で有効 | 既定は無効(set -g mouse on) |
| 操作の API | CLI と JSON のソケット API | tmux のコマンド(send-keys・capture-pane など) |
| 設定ファイル | TOML(config.toml) | tmux のコマンドを並べた .tmux.conf |
| ライセンス | Apache 2.0 | ISC |
tmux で2つのペインを動かした実物(tmux 3.4)
手元の tmux 3.4 で、自分専用のソケットにセッションを作り、左のペインでビルドに見立てたループ、右のペインで「Proceed? [y/N]」と聞いて止まるコマンドを動かしました(capture の出力は、空行と、打ち込んだコマンドの折り返しの行を省いています)。
--- list-sessions
agents: 1 windows (created Wed Nov 18 02:52:09 2026)
--- list-panes
0 3496 bash 60x40
1 3499 bash 59x40
--- capture 0
build-step-1
build-step-2
build-step-3
DONE
bash-5.2#
--- capture 1
bash-5.2# read -p "Proceed? [y/N] " a
Proceed? [y/N]
tmux はコマンド名(どちらも bash)は返しますが、右のペインが入力を待っていることは知りません。知るには capture-pane の文字を自分で読みます。herdr はこの「画面の下を読んで状態を決める」部分を、エージェントごとの規則として持っています。
herdr の中で tmux を動かすと、herdr はその中のエージェントを見分けません(公式の注意)。シェルの起動時に tmux へ自動でつなぐ設定をしている場合は、公式の案内どおり HERDR_ENV で herdr のペインを除きます。手元の bash で、値の有無で分かれることを確かめました(値の中身は公式に記載がないため、有無だけで判定しています)。
if [ -n "$HERDR_ENV" ]; then
: # herdr のペインでは tmux に入らない
elif [ -z "$TMUX" ]; then
tmux new -A -s main
fi
HERDR_ENV unset: would run tmux new -A -s main
HERDR_ENV=1: tmux auto-attach skipped
tmux のキーと .tmux.conf は関連記事「tmuxの使い方|キーバインド早見表とコピペ用.tmux.conf」で扱っています。
herdrのプラグインとデータの扱い(使う前の確認)
この節では、プラグインの入れ方と、AI エージェントにコードを渡す前に確かめることが分かります。
herdr のプラグインは、手元で動く普通のプログラムです。公式は、herdr はプラグインのコードを審査せず、隔離(サンドボックス)もしない、と書いています。入れるのは herdr plugin install owner/repo/subdir、外すのは herdr plugin uninstall <id> です。
- 1プラグインは信頼できる作者のものだけ入れる前にマニフェストとスクリプトを読む(公式の案内)。会社の PC では所属先の決まりに従う
- 2エージェントに渡すコード・データの扱いを確かめる機密情報・個人情報を扱う前に、各エージェントの提供元の最新の規約と所属先の決まりを確かめる
- 3herdr.dev との通信を知っておく版の確認と検出マニフェストの更新は設定の [update] で止められる(version_check・manifest_check)
- 4画面の履歴の保存は必要なときだけトークンが画面に出ることがあるため既定は無効。有効にするなら保存ファイルの扱いを決める
herdr は、エージェントが外へ何を送るかを決めるツールではありません。何をどこへ送るかは、それぞれのエージェントの提供元の説明に従います。Claude Code の基本の使い方は関連記事「Claude Code 使い方|最初の30分と113コマンド【2026年11月】」で扱っています。
herdrがうまくいかないときの症状表
この節では、herdr でつまずきやすい症状と、公式の記載にもとづく確かめ方・直し方が分かります。
| 症状 | 原因 | 確かめ方・直し方 |
|---|---|---|
herdr: command not found | 入れた場所が PATH に入っていない | ターミナルを開き直す。手動なら ~/.local/bin などが PATH にあるか見る |
| Windows でインストールのコマンドが止められる | 所属先のセキュリティの設定 | 設定は変えずに、所属先の管理者に相談する |
| エージェントが状態の無い端末として出る | 一覧にないエージェント、またはラッパー経由で起動している | ラッパーのコマンドにだけ HERDR_AGENT=claude のように付ける(全体には付けない) |
| tmux の中のエージェントが見分けられない | herdr は herdr のペインの中の tmux を読まない | herdr のペインで直接エージェントを起動する |
| 入力を待っているのに idle と出る | 知られている承認の画面に合わない | herdr agent explain で理由を見る。ペインを開いて読む |
| 再起動したらテストやサーバーが消えた | サーバーの停止でプロセスは戻らない | 長く動かすものはデタッチで残す。配置だけが戻る仕様 |
| 設定を書き換えても変わらない | 読み直していない・起動時だけ読む項目 | herdr server reload-config。起動時だけ読む項目は herdr を起動し直す |
| 日本語入力の候補の窓がずれる | カーソルの描き方(Windows で起きやすい) | 公式の Windows のページの記載を確かめ、ui.host_cursor の設定を見直す |
原因が分からないときは、HERDR_LOG=herdr=debug でログを詳しくし、~/.config/herdr/ のログを見ます。
herdrを使うかの判断表
この節では、herdr・tmux・エージェントだけ、のどれで始めるかを場面ごとに選べます。
| 場面 | 向く選び方 | 理由 |
|---|---|---|
| エージェントを1つだけ使う | エージェントだけ | 並べるものが無いので、まず単体の操作に慣れる |
| 2つ以上を並べ、止まったものにすぐ気づきたい | herdr | blocked がサイドバーに出る |
| 閉じても作業を続けたい(ノート PC を閉じる) | herdr か tmux | どちらもサーバーがペインを持ち続ける |
| エージェントから別のエージェントを起動・待機したい | herdr | CLI とソケット API に agent wait・prompt がある |
| 手に馴染んだ .tmux.conf をそのまま使いたい | tmux | herdr は TOML で書き方が違う |
| 同じリポジトリで並べる | herdr+worktree | herdr はファイルを分けないので、フォルダーを分ける |
よくある質問
Q. herdrとは何ですか? A. Claude Code・Codex などの AI コーディングエージェントを1つのターミナルの中に並べて動かし、作業中・入力待ち・完了を見分けて表示するツールです。裏のサーバーがペインを持ち続けるので、画面を閉じても作業は止まりません。
Q. herdr は無料ですか? A. 公式サイトは無料と書いていて、Apache License 2.0 のオープンソースです。ただし並べるエージェント(Claude Code など)の料金は、それぞれの提供元の料金になります。
Q. herdr のインストール方法は?
A. macOS・Linux は curl -fsSL https://herdr.dev/install.sh | sh、brew install herdr、mise use -g herdr のどれかです。Windows は PowerShell の公式のコマンド(irm https://herdr.dev/install.ps1 | iex)で入れます。入れたら herdr で起動します。
Q. Windows で使えますか?
A. 使えます。公式のページでは Windows をベータと表示していて、ConPTY で動くこと、herdr terminal attach やサーバーの引き継ぎは使えないことなどを一覧にしています。
Q. herdr を抜けても Claude Code は動き続けますか?
A. ctrl+b q のデタッチや画面を閉じた場合は動き続けます。herdr server stop やサーバーの再起動では、動いていたプロセスは止まり、配置だけが戻ります(連携を入れたエージェントは会話に戻れます)。
Q. プレフィックスを ctrl+a に変えられますか?
A. 変えられます。~/.config/herdr/config.toml の [keys] に prefix = "ctrl+a" と書き、herdr server reload-config で反映します。配列で複数のプレフィックスも書けます。
Q. tmux と一緒に使えますか?
A. herdr のペインの中で tmux を動かすことはできますが、その中のエージェントの状態は herdr に出ません。シェルの起動時に tmux へ自動でつなぐ設定は、HERDR_ENV で herdr のペインを除きます。
Q. アプリ版の Herdr と何が違いますか? A. アプリ版はネイティブのデスクトップアプリで、裏で herdr-core が動き、スマホのアプリからも状態を見られます。この記事の herdr(Herdr TUI)はターミナルの中で動く版で、両者はエージェントのセッションを共有しません。
まとめ
- herdr は、AI エージェントを1つのターミナルに並べ、blocked・working・done・idle を見分けて表示するオープンソースのツール(Apache 2.0、2026年11月18日時点の Latest は v0.9.5)。
- 入れ方は install.sh・Homebrew・mise・Nix・手動、Windows は PowerShell。起動は
herdr、デタッチはctrl+b q、終了はherdr server stop。 - キーは tmux と同じプレフィックス
ctrl+b。右に分割はv、下は-、新しいタブはc、一覧は?。設定は~/.config/herdr/config.toml。 - 同じリポジトリで並べるなら worktree でフォルダーを分ける。サーバーが止まるとプロセスは戻らず配置だけが戻る。
- プラグインは審査・隔離されない普通のコード。エージェントに渡すデータは、提供元の最新の規約と所属先の決まりを確かめてから。
参考・出典
いずれも2026年11月18日に確認しました。
- herdr 公式サイト:https://herdr.dev/
- Herdr TUI:https://herdr.dev/tui/
- herdr ドキュメント「Install」:https://herdr.dev/tui/docs/install/
- herdr ドキュメント「Quick start」:https://herdr.dev/tui/docs/quick-start/
- herdr ドキュメント「Concepts」:https://herdr.dev/tui/docs/concepts/
- herdr ドキュメント「Configuration」:https://herdr.dev/tui/docs/configuration/
- herdr ドキュメント「Config reference」:https://herdr.dev/tui/docs/config-reference/
- herdr ドキュメント「Agents」:https://herdr.dev/tui/docs/agents/
- herdr ドキュメント「Socket API」:https://herdr.dev/tui/docs/socket-api/
- herdr ドキュメント「Session state」:https://herdr.dev/tui/docs/session-state/
- herdr ドキュメント「Connecting machines」:https://herdr.dev/tui/docs/connecting-machines/
- herdr ドキュメント「Plugins」:https://herdr.dev/tui/docs/plugins/
- herdr ドキュメント「Windows support」:https://herdr.dev/tui/docs/windows-beta/
- herdr プライバシー:https://herdr.dev/privacy/
- GitHub「herdrdev/herdr」:https://github.com/herdrdev/herdr
- GitHub「herdrdev/herdr」Releases:https://github.com/herdrdev/herdr/releases
本記事の内容は、ご自由にお使いください。
ご利用の際は、出典として本ページへのリンクを記載いただけますようお願いします。
(記載例)出典:株式会社RJC「herdrとは|AIエージェントを並べて動かす使い方・キー一覧・tmuxとの違い」
株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。
WE ARE HIRING
RJCで一緒に開発しながら、
成長を楽しみませんか?
RJCは、Web・モバイル・AIを活用した開発プロジェクトで、テックリードやPM・PMOも活躍するシステム開発会社です。会社を知る、待遇を確かめる、話を聞いてみる。気になるところ見てみてください!
- 127日年間休日
- 12時間平均残業時間
- 毎日ガチャ遊びココロも大切にする福利厚生。アマギフなどの賞品ラインナップ!
ほかにも、チケットレストラン、書籍読み放題、2年ごとの慰労報奨(休暇 or 金一封)、11期連続の黒字決算。