クイックスタート
Herdr をまだインストールしていない場合はインストールを参照してください。その後、任意のプロジェクトディレクトリから Herdr を起動します:
herdrHerdr はデフォルトのバックグラウンドセッションを起動するか、それにアタッチします。ソケットを管理する必要はありません。デタッチしてもエージェントは動き続けます。
ワークスペースを作成する
Section titled “ワークスペースを作成する”セッションにワークスペースがない場合、Herdr は自動的にひとつ開きます。ワークスペースはタブ、ペイン、エージェントを入れるプロジェクト単位のコンテナです。アクティブなプロジェクトごとに専用のワークスペースを作ってください。そうすることでサイドバーのエージェント状態が読みやすくなります。
マウスを使う
Section titled “マウスを使う”Herdr はマウスネイティブなので、まずはクリックから始めてください。ペイン、タブ、ワークスペース、エージェントをクリックしてフォーカスします。分割境界をドラッグしてリサイズします。右クリックでコンテキストメニューが開き、ペインの分割やタブの作成ができます。テキストをドラッグ選択するとクリップボードにコピーされます。トークンをダブルクリックすると選択し、2 回目の押下を保持してドラッグすると単語単位で選択を広げられます。どちらもマウスを離すとコピーされます。コピーに Ctrl+C は不要です。
ターミナルが修飾キー付きクリックを Herdr に渡す場合、Ctrl+クリックでペイン内のリンクを開けます。OSC 8 ハイパーリンクと http:// または https:// の URL に対応し、折り返されたリンクの先頭や末尾が表示範囲外でも開けます。Ctrl を押しながらリンク上にポインターを移動すると、表示中の部分に下線が付きます。ポインターを外す、ペイン内容が変わる、または Ctrl の解放イベントを受け取ると下線は消えます。一部のターミナルでは、修飾キーの変化はマウス移動時にだけ報告されます。macOS では、マウスキャプチャが有効な間は Herdr が処理するペインリンクに Ctrl+クリックを使ってください。Cmd+クリックは Shift+Cmd+クリックや ui.mouse_capture = false といったターミナルネイティブのバイパス経路でのみ使えます。
ui.right_click_passthrough_modifier を設定すると、その修飾キー + 右クリックで、右クリック・ホールド・ドラッグのジェスチャーがマウスレポーティング対応のペインアプリに送られます。
エージェントを動かす
Section titled “エージェントを動かす”ペインの中でコーディングエージェントを起動します:
claudecodex、pi、opencode など、他の対応エージェントでも構いません。Herdr は自動的に検出します。サイドバーには各エージェントが working、blocked、done、idle のどれかが表示されます — すべてのワークスペースを横断して表示されるので、どのプロジェクトがあなたを必要としているか常に分かります。
キーボード操作
Section titled “キーボード操作”キーボード操作は任意です。マウスですべての操作ができます。ctrl+b を押してプレフィックスモードに入り、アクションキーを押します。
よく使うアクション:
| アクション | キー |
|---|---|
| 右に分割 | prefix+v |
| 下に分割 | prefix+minus |
| 新しいタブ | prefix+c |
| 次 / 前のタブ | prefix+n / prefix+p |
| ワークスペースナビゲーション | prefix+w |
| 新しいワークスペース | prefix+shift+n |
| クライアントをデタッチ | prefix+q |
プレフィックスの考え方が初めてなら、キーボードでプレフィックスとは何か、なぜマルチプレクサがこれを使うのか、プレフィックスなしで運用する方法を説明しています。Herdr 内で prefix+? を押すとすべての有効なバインドが表示され、prefix+[ でコピーモードに入ってキーボードからコピーできます。
デタッチして戻ってくる
Section titled “デタッチして戻ってくる”prefix+q を押すか、単純にターミナルウィンドウを閉じてください。Herdr サーバーとすべてのエージェントは動き続けます。もう一度 herdr を実行すると同じセッションに再アタッチします。
セッションを本当に終了してペインを停止するには:
herdr server stop次に読むもの
Section titled “次に読むもの”- コンセプト — ワークスペース、タブ、ペイン、エージェントのモデルを 2 分で。
- Herdr での作業の進め方 — ローカル、SSH、スマートフォン、
herdr --remoteのワークフロー。 - エージェント — 対応エージェント、検出、状態の精度を高めるインテグレーション。
- 設定 — キーバインド、テーマ、通知、その他すべて。