Actions
操作
Click a card to go to the session. Right-click for everything else. Shepherd never steals focus — it acts only when you tell it to.
カードをクリックするとそのセッションに移動します。それ以外の操作はすべて右クリックから。 Shepherd は決してフォーカスを奪いません — あなたが指示したときだけ動きます。
Click: jump into the session
クリック: セッションへジャンプ
- zellij session — attaches the zellij session in your terminal and focuses the exact pane, even in a multi-pane tab.
- VS Code integrated terminal or Claude Code extension panel — raises the editor window that has the session's folder open. The card remembers which app hosts it, so Cursor/Windsurf-style forks are covered by design (untested — no fork on the bench yet). These cards wear a small
</>mark. - Background worker — opens its live TUI with
claude attach <id>in a new terminal window. A finished record asks first, then reopens the session where it left off. - Bare-terminal session — Shepherd can see it but can't know which window it lives in; the card says so instead of jumping.
- Teammate / subagent — runs inside its parent's process; there is nothing to attach to. Steer it from the parent session.
- zellij セッション — ターミナルでその zellij セッションに attach し、マルチペインのタブでも該当ペインに正確にフォーカスします。
- VS Code 統合ターミナル / Claude Code 拡張パネル — そのセッションのフォルダを開いているエディタウィンドウを前面に出します。どのアプリに居るかをカードが覚えているため、Cursor / Windsurf 系のフォークにも対応する設計です（フォークでの動作は未検証）。このカードには小さな
</>マークが付きます。 - バックグラウンドワーカー — 新しいターミナルウィンドウで
claude attach <id>を実行し、ライブ TUI を開きます。終了済みの記録はまず確認を挟み、そのセッションを中断した場所から再開します。 - 素のターミナルのセッション — Shepherd はその存在を認識できますが、どのウィンドウに居るかは分からないため、ジャンプせずカードにその旨を表示します。
- teammate / サブエージェント — 親のプロセス内で動くため、attach する対象がありません。親セッションから操作してください。
Reply to a blocked agent
応答待ちのエージェントに回答する
When a card goes orange, the question is on the card. Right-click → Reply opens an inline answer box — the full question text, a copy button, and a field to type into. Your answer is delivered on whatever channel the session actually listens on:
カードがオレンジになると、その質問がカードに表示されます。右クリック→回答する でインラインの回答ボックスが開きます — 質問文の全文、コピーボタン、入力用のフィールドが並びます。 回答はそのセッションが実際に受け取れるチャネルを通じて届けられます:
- a zellij session gets keystrokes typed into its pane (works without switching windows; for multi-pane tabs a client must be attached somewhere);
- a background worker gets the reply over the cc-daemon control socket — the same channel
claude attachuses; - a VS Code terminal accepts no outside keystrokes, so there is no inline reply — click the card instead: it raises the editor with keyboard focus, and you answer right there.
- zellij セッションには、そのペインへキー入力が送られます（ウィンドウを切り替えずに動作しますが、マルチペインのタブではどこかにクライアントが attach している必要があります）;
- バックグラウンドワーカーには cc-daemon control socket 経由で回答が届きます —
claude attachが使うのと同じチャネルです; - VS Code のターミナルは外部からのキー入力を受け付けないため、インライン回答はありません — 代わりにカードをクリックしてください。キーボードフォーカスごとエディタが前面に出るので、そのまま回答できます。
After sending, the card shows reply sent · waiting until the agent picks it up.
送信後、カードはエージェントが受け取るまで reply sent · waiting と表示します。
The right-click menu
右クリックメニュー
| item | what it does |
|---|---|
| Reply | Answer a blocked agent inline (first item whenever the card is waiting). |
| Attach zellij ↗ / Open in VS Code ↗ / Attach ↗ | Same as clicking the card. |
| Copy `claude attach <id>` | For opening a background worker in a terminal of your choosing. |
| Remote-control | Enables /remote-control for the session so you can drive it from another device. |
| Capture a region & send | Select a screen region; the screenshot lands in the session as a file. The HUD hides itself during capture. |
| Stop background agent | claude stop via the daemon — frees the ~600 MB a parked worker holds. Verified: the card only clears once the worker is actually gone. |
| End session | Ends an interactive session — refused while the worktree has uncommitted changes, so closing never loses work. Commit or stash first. |
| Delete record (claude rm)… | Removes a finished background record from the roster (the transcript stays on disk). |
| Reset to auto layout | Undo manual card placement (you can drag cards between columns to pin them). |
| 項目 | できること |
|---|---|
| 回答する | 応答待ちのエージェントにインラインで回答します（カードが待機中のときは常に先頭に表示）。 |
| zellij を開く ↗ / VS Code で開く ↗ / attach で開く ↗ | カードをクリックしたときと同じ動作です。 |
| claude attach <id> をコピー | 好きなターミナルでバックグラウンドワーカーを開くために使います。 |
| 遠隔操作（/remote-control） | そのセッションで /remote-control を有効にし、別のデバイスから操作できるようにします。 |
| 範囲を撮影して送る | 画面の範囲を選択すると、そのスクリーンショットがファイルとしてセッションに届きます。撮影中は HUD 自身を隠します。 |
| バックグラウンドを停止（claude stop） | daemon 経由で claude stop を実行します — 待機中のワーカーが確保している約600MBを解放します。ワーカーが実際に消えたことを確認してからカードを消します。 |
| セッションを終了する | 対話型セッションを終了します — worktree に未コミットの変更がある間は拒否されるため、作業を失うことはありません。先にコミットまたは stash してください。 |
| 記録を削除（claude rm）… | 終了済みのバックグラウンド記録を名簿から削除します（transcript はディスクに残ります）。 |
| 自動配置に戻す | 手動で配置したカードを元に戻します（カードは列間にドラッグして固定できます）。 |
Drop files onto a card
カードにファイルをドロップする
Drag any file from Finder onto a card. Shepherd copies it to a scratch directory, asks for an optional message, and sends the path(s) into that session — the agent can read the file immediately. The card shows a 📎 sent mark right after.
Finder から任意のファイルをカードへドラッグします。Shepherd はそれをスクラッチディレクトリに コピーし、任意のメッセージを尋ねてから、そのパスをセッションへ送ります — エージェントはすぐに ファイルを読めます。直後にカードには 📎 sent マークが表示されます。
＋ New session, in a fresh worktree
＋新規セッション（新しい worktree で）
The ＋ button in the header opens a repository picker (your ghq base directories),
creates an isolated git worktree for the branch name you give it, and launches
claude there in a new terminal window. Parallel work without two agents stepping
on one checkout.
ヘッダーの＋ボタンはリポジトリピッカー（あなたの ghq のベースディレクトリ）を開き、
指定したブランチ名で隔離された git worktree を作成し、新しいターミナルウィンドウで
そこに claude を起動します。2つのエージェントが同じチェックアウトを踏み合うことなく
並列作業できます。
HUD size & placement
HUD のサイズと配置
- ⚙ → HUD size — auto (fits content), fixed 1 / 2 / 3-column presets, or full display. Fixed sizes scroll vertically.
- Drag anywhere — the position is remembered per display.
- Minimize — collapses to a small strip showing just the count pills; blocked agents still surface.
- ? button — the in-app legend for every symbol (the same content as Reading the board).
- ⚙ → HUD サイズ — auto（内容に合わせる）、固定の1/2/3列プリセット、または full display（画面全面）。固定サイズは縦方向にスクロールします。
- どこからでもドラッグ可能 — 位置はディスプレイごとに記憶されます。
- 最小化 — 件数ピルだけを示す小さなストリップに折りたたまれます。応答待ちのエージェントは折りたたんでも表示されます。
- ?ボタン — すべてのシンボルのアプリ内凡例（盤面の読み方と同じ内容）。