Configuration
設定
There is no config file and nothing you must set. Day-to-day preferences (position, size mode,
collapsed columns, Stream Deck on/off, board filter) are set in the UI and remembered.
The keys below exist for the rare cases the defaults guess wrong — all optional, via
defaults write com.sadayuki-matsuno.shepherd <key> <value>.
設定ファイルは無く、必須の設定もありません。日常的な好み（位置・サイズモード・列の折りたたみ・
Stream Deck の ON/OFF・盤面の表示範囲フィルタ）はすべて UI で設定し、自動的に記憶されます。
以下のキーは、デフォルトの推測がまれに外れる場合のためのもので、すべて任意です。
defaults write com.sadayuki-matsuno.shepherd <key> <value> で設定します。
Tool paths & terminal
ツールパスとターミナル
| key | default | what it does |
|---|---|---|
| terminalApp | Ghostty if installed, else Terminal | Terminal app used for jumping into sessions and opening new ones. |
| ghPath | auto-detected (homebrew paths) | Path to gh for PR/CI badges. Set to "" to disable PR lookup entirely. |
| claudePath | auto-detected | Path to the claude CLI (used for claude stop / attach / the roster). |
| zellijPath | auto-detected | Path to zellij for jump & send. |
| ghqPath | auto-detected | Path to ghq — powers the ＋ new-session repository picker. |
| キー | デフォルト | 説明 |
|---|---|---|
| terminalApp | Ghostty がインストールされていればそれ、無ければ Terminal | セッションへのジャンプや新規セッションのオープンに使うターミナルアプリ。 |
| ghPath | 自動検出（homebrew 配下のパス） | PR/CI バッジ用の gh のパス。"" を設定すると PR 取得を完全に無効化。 |
| claudePath | 自動検出 | claude CLI のパス（claude stop / attach / 名簿取得で使用）。 |
| zellijPath | 自動検出 | ジャンプ・送信用の zellij のパス。 |
| ghqPath | 自動検出 | ghq のパス — ＋新規セッションのリポジトリピッカーが使用。 |
Auto-detection checks /opt/homebrew/bin and /usr/local/bin (GUI apps get a
stripped PATH). If a tool lives elsewhere, set its key explicitly.
自動検出は /opt/homebrew/bin と /usr/local/bin を確認します（GUI アプリは
PATH が削られた状態で起動するため）。ツールが別の場所にある場合は、該当キーを明示的に設定してください。
Gauges & alerts
ゲージとアラート
| key | default | what it does |
|---|---|---|
| quotaAlertPercent | 90 | Percent at which a weekly plan-usage window is mirrored into the header as an alert chip. |
| contextLimits | built-in mapping | Override the assumed context-window size per model (used by the card gauge). The transcript doesn't record window sizes, so Shepherd maps model names to sizes — correct it if a model changes:defaults write com.sadayuki-matsuno.shepherd contextLimits -dict-add sonnet-5 -int 1000000 |
| キー | デフォルト | 説明 |
|---|---|---|
| quotaAlertPercent | 90 | 週間プラン使用量ウィンドウをヘッダーのアラートチップとしてミラー表示する閾値（%）。 |
| contextLimits | 組み込みマッピング | モデルごとに想定するコンテキストウィンドウサイズを上書き（カードのゲージが使用）。transcript にはウィンドウサイズが記録されないため、Shepherd はモデル名からサイズを実測ベースで写像しています — モデルの仕様が変わった場合は補正してください:defaults write com.sadayuki-matsuno.shepherd contextLimits -dict-add sonnet-5 -int 1000000 |
Stream Deck
| key | default | what it does |
|---|---|---|
| deckSerial | first device found | Pin a specific Stream Deck by serial number when several are connected. |
| キー | デフォルト | 説明 |
|---|---|---|
| deckSerial | 最初に見つかったデバイス | 複数の Stream Deck が接続されている場合、シリアル番号で特定の1台に固定する。 |
Turning the deck on/off lives in the UI: ⚙ → Use Stream Deck. See Stream Deck.
デッキの ON/OFF は UI にあります: ⚙ → Use Stream Deck。Stream Deck を参照してください。
Language
言語
The UI follows your system language — Japanese or English. No key to set.
UI はシステム言語（日本語または英語）に追従します。設定するキーはありません。