クイックスタート

Herdr をまだインストールしていない場合はインストールを参照してください。その後、任意のプロジェクトディレクトリから Herdr を起動します:

herdr

Herdr はデフォルトのバックグラウンドセッションを起動するか、それにアタッチします。ソケットを管理する必要はありません。デタッチしてもエージェントは動き続けます。

ワークスペースを作成する

セッションにワークスペースがない場合、Herdr は自動的にひとつ開きます。ワークスペースはタブ、ペイン、エージェントを入れるプロジェクト単位のコンテナです。アクティブなプロジェクトごとに専用のワークスペースを作ってください。そうすることでサイドバーのエージェント状態が読みやすくなります。

マウスを使う

Herdr はマウスネイティブなので、まずはクリックから始めてください。ペイン、タブ、ワークスペース、エージェントをクリックしてフォーカスします。分割境界をドラッグしてリサイズします。右クリックでコンテキストメニューが開き、ペインの分割やタブの作成ができます。テキストをドラッグ選択するとクリップボードにコピーされます。トークンをダブルクリックすると直接コピーされます。コピーに Ctrl+C は不要です。

ターミナルが修飾キー付きクリックを Herdr に渡す場合、Ctrl+クリックでペイン内のリンクを開けます。これは OSC 8 ハイパーリンクと、表示されている http:// または https:// の URL で機能します。macOS では、マウスキャプチャが有効な間は Herdr が処理するペインリンクに Ctrl+クリックを使ってください。Cmd+クリックは Shift+Cmd+クリックや ui.mouse_capture = false といったターミナルネイティブのバイパス経路でのみ使えます。

ui.right_click_passthrough_modifier を設定すると、その修飾キー + 右クリックで、右クリック・ホールド・ドラッグのジェスチャーがマウスレポーティング対応のペインアプリに送られます。

エージェントを動かす

ペインの中でコーディングエージェントを起動します:

claude

codex、pi、opencode など、他の対応エージェントでも構いません。Herdr は自動的に検出します。サイドバーには各エージェントが working、blocked、done、idle のどれかが表示されます — すべてのワークスペースを横断して表示されるので、どのプロジェクトがあなたを必要としているか常に分かります。

キーボード操作

キーボード操作は任意です。マウスですべての操作ができます。ctrl+b を押してプレフィックスモードに入り、アクションキーを押します。

よく使うアクション:

アクション	キー
右に分割	prefix+v
下に分割	prefix+minus
新しいタブ	prefix+c
次 / 前のタブ	prefix+n / prefix+p
ワークスペースナビゲーション	prefix+w
新しいワークスペース	prefix+shift+n
クライアントをデタッチ	prefix+q

プレフィックスの考え方が初めてなら、キーボードでプレフィックスとは何か、なぜマルチプレクサがこれを使うのか、プレフィックスなしで運用する方法を説明しています。Herdr 内で prefix+? を押すとすべての有効なバインドが表示され、prefix+[ でコピーモードに入ってキーボードからコピーできます。

デタッチして戻ってくる

prefix+q を押すか、単純にターミナルウィンドウを閉じてください。Herdr サーバーとすべてのエージェントは動き続けます。もう一度 herdr を実行すると同じセッションに再アタッチします。

セッションを本当に終了してペインを停止するには:

herdr server stop

次に読むもの

• コンセプト — ワークスペース、タブ、ペイン、エージェントのモデルを 2 分で。
• Herdr での作業の進め方 — ローカル、SSH、スマートフォン、herdr --remote のワークフロー。
• エージェント — 対応エージェント、検出、状態の精度を高めるインテグレーション。
• 設定 — キーバインド、テーマ、通知、その他すべて。