Herdr入門：複数AIエージェントを1つのターミナルで束ねる

Herdrとは

こんにちは！今日は「Herdr」について学びましょう。

Claude CodeやCodexといったAIコーディングエージェントを使っていると、こんな場面に遭遇しませんか？

• 複数のエージェントを同時に走らせているけど、どれが入力待ち（blocked）なのか分からず、いちいちペインを見て回っている
• ノートPCを閉じたらエージェントの作業が止まってしまう
• スマホからサーバーのエージェントに接続したいけど、tmux越しだと画像貼り付けやマウス操作がうまく動かない

Herdr（ハーダー）は、まさにこうした悩みを解決するために生まれたAIコーディングエージェント専用のマルチプレクサです。「one terminal for the whole herd（群れ全体を1つのターミナルで）」を掲げ、Rust製の単一バイナリとして既存のターミナルの中で動作します。tmuxがターミナルに対して果たす役割を、Herdrはエージェントに対して果たす——そう考えると分かりやすいですよ。

なぜtmuxではダメなのか

tmuxは素晴らしいツールですが、AIエージェントが存在する前に設計されました。そのため、tmuxには「エージェントの状態」という概念がありません。

• Claude Codeがタスクを終えてあなたの入力を待っていても、tmuxはそれを知らせてくれません
• Codexが権限確認のプロンプトで止まっていても、tmuxはフラグを立ててくれません
• 結局、あなたは全ペインを手動でのぞいて回ることになります

Herdrはここにエージェント状態の自動検出を持ち込みました。各ペインのエージェントが「idle（待機）／working（作業中）／done（完了）／blocked（入力待ち・ブロック）」のどれなのかを、Herdrが自動で判別して一覧表示してくれます。

tmux・cmuxとの違い

「AIエージェント向けターミナル」というジャンルには、tmux・cmux・Herdrなど複数の選択肢があります。まずは全体像を整理しましょう。

🔄 使い分けのポイント: cmuxは「macOSローカルで完結する開発」に強いGUIアプリ、Herdrは「クロスプラットフォーム＆リモートサーバー」でエージェントを束ねたい人に強いターミナル内バイナリです。tmuxからの乗り換えを考えているなら、キーバインドが似ているHerdrは移行コストが低いですよ！

インストール

HerdrはLinux/macOSが安定版、Windowsはプレビューベータです。いくつかの方法が用意されています。

インストールスクリプト（Linux / macOS・推奨）

もっとも手軽なのが公式のインストールスクリプトです。

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

パッケージマネージャー

すでにHomebrewやNixを使っている方は、そちらからも導入できます。

# Homebrew
brew install herdr

# Mise（グローバルに導入）
mise use -g herdr

# Nix（ビルド不要で即実行）
nix run github:ogulcancelik/herdr

Windows（プレビューベータ）

WindowsはまだベータですがPowerShellから試せます。

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

アップデート

インストールスクリプト経由で入れた場合は、専用コマンドで更新できます。

# Herdr自身を最新版に更新（インストーラー管理版）
herdr update

基本的な使い方

起動と接続

インストールが終わったら、herdr と打つだけでサーバーが起動します。すでにセッションが動いていれば、そこに再接続します。

# サーバーを起動、または既存セッションに再接続
herdr

# キーバインド一覧を表示（迷ったらまずこれ）
# ctrl+b then ?

Herdrのプレフィックスキーは ctrl+b です。tmuxと同じなので、ctrl+b を押してからコマンドキーを押す、という操作感覚もそのまま活かせます。

ペイン・タブ・ワークスペースの操作

Herdrは「ペイン（画面分割）」「タブ」「ワークスペース」の3階層で作業を整理します。よく使うキーバインドは次のとおりです。

🔍 注目ポイント: ctrl+b プレフィックスはtmux・zellij経験者にはおなじみの操作体系です。「プレフィックスを押してから1キー」というリズムを覚えるだけで、分割もタブもワークスペースもすべて操作できます。

エージェント状態の可視化

Herdrの真骨頂が、各ペインで動くエージェントの状態表示です。

• 🔴 blocked: あなたの入力・承認待ちで止まっている（最優先で対応すべき状態）
• 🟡 working: エージェントが作業中
• 🔵 done: タスク完了
• 🟢 idle: 待機中（何もしていない）

サイドバーが全エージェントをこの4状態に集約してくれるので、どのペインが blocked（あなた待ち）なのかがひと目で分かります。しかもフック設定や事前準備は不要で、ゼロコンフィグで動くのが嬉しいポイントです。「全ペインを見て回って、どれが止まっているか探す」という無駄がなくなるわけですね。

マルチエージェント並列開発

Herdrがもっとも輝くのは、複数のAIエージェントを同時に動かすときです。

典型的なレイアウト例

# 1. herdr を起動
herdr

# 2. ペインを分割（ctrl+b → v）して2ペインに
# 3. 左ペインで Claude Code を起動
claude

# 4. 右ペインをさらに分割（ctrl+b → -）
# 5. 右上で Codex、右下でテスト実行

# これで3つの作業が1画面に並ぶ
# blocked になったペインだけ対応すればOK

この構成なら、左のClaude Codeがフロントエンド、右上のCodexがバックエンドを進め、右下でテストを回す、といった並列開発が1画面で完結します。どれかが blocked になったら、その状態表示を頼りにそのペインへ移動して承認するだけです。

🔄 並列作業のコツ: 各エージェントに「フロントエンド担当」「バックエンド担当」のように明確なタスクを割り当て、blocked 表示が出たペインから順に対応していくと、複数エージェントを一人で無理なくさばけます。

リモートSSHでの利用

Herdrはリモートサーバー上のエージェントを、手元のターミナルからそのまま操作できます。

# リモートのHerdrサーバーに接続する
herdr --remote ssh://user@server

こうすると、手元のターミナルがリモートHerdrサーバーの「クライアント」になります。エージェントはサーバー側の本物のターミナルで動き続けるので、ノートPCを閉じても作業は止まりません。

「素のSSH + tmux」より優れている点

「SSHでつないでtmuxを動かせば同じでは？」と思うかもしれません。しかしHerdrの--remoteでは、素のSSH + tmuxではうまく動かないことが、そのまま動きます。

• 画像の貼り付け: エージェントにスクリーンショットを渡す操作がリモートでも機能する
• マウス操作: ペインのクリック切り替えやスクロールがそのまま使える
• 状態トラッキング: リモートのエージェントの working/blocked 状態も手元で把握できる

Socket APIでエージェントを自動制御

Herdrにはローカルのソケット経由でワークスペースをプログラム制御できるSocket APIが備わっています。これを使うと、エージェント自身やスクリプトからHerdrを操作できます。

できること

• ワークスペースの作成
• ペインの分割・操作
• エージェントの状態購読（state subscription）
• 出力の読み取りと反応

つまり「リードエージェント（司令塔）」が、ヘルパーエージェントを自分で起動し、進捗を監視し、出力を読んで反応する——といったエージェントによるエージェントのオーケストレーションが、あなたがキーボードに触れることなく実現できます。

スキルとして追加する

エージェント連携用のスキルはコマンド一発で追加できます。

# Herdr連携スキルをグローバルに追加
npx skills add ogulcancelik/herdr --skill herdr -g

🔍 注目ポイント: このSocket APIこそ、Herdrが単なる「AIエージェント対応のtmux」を超えている部分です。エージェントがエージェントを指揮する自動化の土台になります。マルチエージェント開発の考え方はcmuxでのマルチエージェント開発の記事とも共通しているので、あわせて読むと理解が深まります。

ライセンスと商用利用

Herdrはデュアルライセンスで提供されています。

• オープンソース: AGPL-3.0-or-later（無料）
• 商用: 別途商用ライセンスが必要

個人利用やオープンソースプロジェクトではAGPL-3.0で無料利用できます。AGPLの条件（ネットワーク経由で提供する場合のソース開示義務など）が自社の利用形態に合わない企業向けに、別途商用ライセンスが用意されています。

🎮 理解度チェック

Q1: Herdrがtmuxに対して持つ最大の強みは？

Q2: Herdrで新しいタブを作成するキーバインドは？

Q3: herdr --remote が素のSSH + tmuxより優れている点は？

ベストプラクティス

Herdr運用のコツ

1. ①ワークスペースをプロジェクト単位で分ける: ctrl+b → shift+n で作成し、ctrl+b → w で切り替える
2. ②エージェントごとにペインを割り当てる: 状態表示を頼りに blocked から順に対応する
3. ③長時間タスクはリモートで: herdr --remote でサーバーに逃がし、PCを閉じても走らせ続ける
4. ④キーバインドは ctrl+b → ? で確認: 覚えるより都度呼び出すほうが早い

tmux・cmuxとの使い分け

• リモートサーバーでエージェントを束ねたい → Herdr（--remote＋状態トラッキング）
• macOSローカルで完結、GUIと内蔵ブラウザが欲しい → cmux
• エージェントを使わない汎用のリモート作業 → tmux

🔒 移行のヒント: tmuxユーザーはプレフィックスが同じ ctrl+b なので学習コストが低く、Herdrへの移行はスムーズです。まずは1プロジェクトで試して、エージェント状態表示の便利さを体感してみましょう。

よくある質問

📝 まとめ

今回はHerdrについて学びました！

Herdrは、AIコーディングエージェントを1つのターミナルで束ねるために設計された、新しいタイプのマルチプレクサでしたね。覚えておきたいポイントをまとめます：

• 単一Rustバイナリ: 既存ターミナル内で動作、GUI・アカウント・テレメトリなし
• エージェント状態の可視化: working / blocked / done / idle を自動検出（16以上のエージェント対応）
• キーバインド: プレフィックスは ctrl+b、分割は v／-、タブは c、ワークスペースは shift+n／w
• リモートSSH: herdr --remote で画像貼り付け・マウス・状態トラッキングまでシームレス
• Socket API: エージェントがエージェントを指揮する自動化の土台

AIエージェントを複数動かす開発が当たり前になる中、「どれが止まっているか」を一目で把握できるHerdrのようなツールは、生産性を大きく左右します。tmuxから移行しやすいのも嬉しいポイントです。

同じくエージェント連携に特化したツールが気になる方は、cmuxでAIコーディングを加速するや、cmuxとtmuxの違いの記事もぜひチェックしてみてください！