using shepherd
Stream Deck
Shepherd can mirror the board onto an Elgato Stream Deck — a physical status panel you glance at and press to jump. Built in: Shepherd talks to the device directly over USB HID. No Elgato plugins, no companion app.
Shepherd は盤面を Elgato Stream Deck — ひと目で確認し、押せばジャンプできる物理ステータスパネル — にミラーできます。組み込み機能なので、 Shepherd はデバイスと USB HID で直接会話します。Elgato のプラグインも専用アプリも不要です。
How the keys are laid out
キーの並び方
- Top screen: one key per repository column. Repo name, session count, and one status-colored dot per session — the column's health at a glance. Key 0 shows the Shepherd logo.
- Press a repo key to drill in: that column's sessions, one key each (status color, title,
#issue), in the same urgency order as the HUD. Key 0 goes back. - Blocked sessions blink — on the session key, and on the repo key holding one, so a waiting agent is visible even from the top screen.
- Press a session key to jump — same as clicking its card in the HUD.
- トップ画面: リポジトリ列ごとに1キー。リポジトリ名・セッション数、そしてセッションごとのステータスドットが並び、その列の状態がひと目で分かります。キー0には Shepherd のロゴが表示されます。
- リポジトリキーを押すと掘り込みます: その列のセッションが1つずつキーに割り当てられ（ステータス色・タイトル・
#issue）、HUD と同じ緊急度順で並びます。キー0で戻ります。 - 応答待ちのセッションは点滅します — セッションキー本体と、それを含むリポジトリキーの両方が点滅するので、トップ画面からでも応答待ちのエージェントに気づけます。
- セッションキーを押せばジャンプします — HUD でカードをクリックするのと同じです。
Turning it on
有効化
Click ⚙ in the HUD header and choose Use Stream Deck. The choice is remembered and the deck reconnects automatically on relaunch.
HUD ヘッダーの ⚙ をクリックして「Use Stream Deck」を選んでください。 この選択は記憶され、再起動時にデッキは自動的に再接続します。
The official Elgato Stream Deck app must be quit first — it and Shepherd can't share
the device. Shepherd refuses to take over while the Elgato app is running.
公式の Elgato Stream Deck アプリを先に終了する必要があります — Shepherd とデバイスを
共有できないためです。Elgato アプリが起動している間、Shepherd はデバイスの制御を拒否します。
Devices
対応デバイス
- Tested on Stream Deck MK.2 (15 keys); Original V2 speaks the same protocol.
- Several decks connected? Shepherd takes the first. Pin one by serial:
defaults write com.sadayuki-matsuno.shepherd deckSerial <serial> - Unplugging is fine — Shepherd drops the deck with a note in the header and reattaches when it's back.
- Stream Deck MK.2（15キー）で動作確認済み。Original V2 も同じプロトコルを話します。
- 複数のデッキを接続した場合、Shepherd は最初の1台を使います。シリアル番号で固定するには:
defaults write com.sadayuki-matsuno.shepherd deckSerial <serial> - 抜いても問題ありません — Shepherd はヘッダーに注記を出してデッキを切り離し、戻ってくれば再接続します。