Shepi for Herdrの使い方。

はじめに

エージェントを動かすのはHerdr、ShepiはそれをMacのウインドウで見せるものです。Shepiを終了しても何も止まりません。

1. Herdr（無料）をインストールします：
   curl -fsSL https://herdr.dev/install.sh | sh
2. Shepiをダウンロードし、アプリケーションにドラッグして開きます。
3. ShepiがHerdrを見つけて起動し、スペースとエージェントを表示します。Herdrがまだない？Shepiがインストールコマンドを「コピー」付きで表示し、インストールされたら接続します。

14日間無料、アカウントもカードも不要。macOS 15以降、Apple siliconとIntel、Herdr 0.9.3以降。ヒント：設定 › 一般 › ログイン時に開くをオンにすると、ShepiがHerdrを起動し、Shepiに与えたMacのアクセス許可がエージェントにも適用されます。

ウインドウ

123456

1. スペース：プロジェクトと、そのブランチ、各スペースのエージェント数。マシンが2台以上なら、マシンごとのヘッダの下に。
2. エージェント：すべてのマシンのすべてのエージェントと、右側にその状態と経過時間。
3. タブ：今いるスペースのタブ。
4. ペイン：明るいペインが入力先です。
5. ステータスライン：入力待ちのエージェント、メッセージ、フォルダとそのGit。
6. 検索：その隣に、見逃したものがあるときは受信トレイ、ペインを外しているあいだはバックグラウンドのトレイ。

色の意味は1つずつです：アンバーは入力待ち、青は作業中、緑は完了、グレーはアイドル。

キー

入力した内容はペインに送られます。2種類のショートカットだけはShepiに届きます：

• キーを忘れたら？⌃Bを押して待つと、今押せるキーが帯に表示されます。右側には自分のマクロ。
• すべてのキー：?、またはステータスライン右端の「ショートカット」。入力してReturnで実行できます。
• クリックしたい？すべてのツールチップとメニュー項目にキーが表示されます。

プレフィックスキーはHerdrのものなので、Herdr自身のターミナルアプリと同じです。変更するには、設定 › HerdrでHerdrの設定を開きます。

サイドバー

各スペースには、ペインがあるプロジェクトを合計した、プッシュするコミット数↑とプルするコミット数↓が表示されます。各エージェントには、作ったメーカーのマーク、場所（スペースと、名前が違うときはフォルダ：「Herdi test / herdi」）、ブランチとマシン、状態、そして状態の横に合計の作業時間が表示されます（ポインタを重ねると今回のターンなどが見られます。入力待ちのエージェントはそれだけを表示します）。

スペースとタブ

スペースはプロジェクトのフォルダ、タブはその中のペインのレイアウトの1つです。

1. 「スペース」にポインタを合わせて+をクリックすると新しいスペースができます。そのあとプロジェクトにcdします。
2. スペースを右クリック › ここでClaude Codeを開始：エージェントの入った新しいタブが開きます。
3. 名前を付けるまで、タブにはエージェントのタスク名が付きます。

ペイン

分割、サイズ変更、閉じる

ズーム

ペインが切れて見える、小さすぎる？別のデバイスがサイズを決めています。Herdr自身のターミナルと同じく、最後にペインを使った人がサイズを決めます：入力、クリック、またはウインドウに戻れば、またこのMacのサイズになります。電話で表示中のペインは、電話が離れるまで電話のサイズのままです。

ペインを並べる

1. ヘッダをつかんでペインをドラッグします。ペインが縮み、後ろのレイアウトが見えます。
2. 別のペインの上で止めます。その左、右、上、下の3分の1なら隣に置き、中央なら2つを入れ替えます。ピルが結果を示します（「testsと入れ替え」「testsの下」）。
3. 離すと配置されます。Escか、元の場所に戻すとキャンセルです。

レイアウトはHerdrのものです。どのデバイスにも同じように表示されます。

エージェントが入力待ちになったら

1. バナー：見ていないタブにあるとき。
2. 確認でそこへ移動します。a（attentionのa）でも同じです（エージェントが何か質問していれば、aは先にその質問を開きます）。
3. エージェントがアンバーになり、実行したい内容が表示されます。
4. ステータスラインに名前が出ます。

1. Herdrのサウンドが鳴ります。ほかのアプリにいるときは、Macの通知がタスクとエージェント、何が起きたか、どれだけ作業したか、複数あるならマシンも伝えます。クリックするとそのペインに移動します。
2. エージェント自身のターミナルで回答します。
3. アンバーが消えます。エージェントが終わると、緑のバナーがそれを伝え、「開く」があります。

受信トレイ

設定 › 通知 › 通知する：離れているとき（Shepiが前面にないか、そのタブが表示されていないとき）、常に、しない。

質問に回答する

エージェントは本当の質問をあなたにできます：何が起きているか、考えられる回答とそれぞれの結果、そして自分で書く欄。

1. すべてのエージェントからの質問は、このMacでもサーバでも、ウインドウ右上の1枚のカードに古い順に並びます。エージェントの説明は、リスト、コード、表も整形して表示されます。質問したエージェントはアンバーになります。
2. 回答をクリックするか、自分で書きます。エージェントのペインと同じように、スクリーンショットやファイルを貼り付けることもできます。カードがウインドウをふさぐことはありません：その間にタブを開いたり、ほかのことをしたりしても、質問は待っています。どのペインからでもa、次に1–9を押します。↓で自分の回答を書き、Gで先にエージェントを見ます。
3. 回答はそのままエージェントに届き、次の質問が表示されます。×で1つを閉じ、Escでペインに戻ります。

10分間回答のない質問はエージェントに戻り、エージェントはターミナルで質問し直します。質問は受信トレイで待ちます。時間は設定 › エージェントで変えられます。

Shepiでエージェントにできること

Shepi は接続した各マシンで、Claude Code、Codex、Gemini CLI、OpenCode、Cursor、Copilot CLI、Amp、Grok Build、Pi のエージェントを自動で設定するので、言われなくてもここで何ができるかがわかります。新しい会話を始めると（/clear、/new）エージェントの時間は最初から数え直します。手動ではエージェントを右クリック › 時間をリセット。エージェントにできること：

予定された引き継ぎがあると、エージェント名の後ろに時計が表示されます。ポインタを重ねるか、エージェントを右クリックすると、内容の確認や「キャンセル」ができます。マシン上で動くので、Shepiを閉じていても実行されます。エージェントのペインで入力すると、入力した内容に置き換わります。

Shepi を一度承認するよう求めるエージェントもあります（Codex など）。Shepi が加えるものにはすべて Shepi の印が付き、Shepi の外では何もせず、プロジェクトのファイルには触れません。設定 › エージェントの「マシンにShepiプラグインをインストールしたままにする」をオフにすると、すべて取り除かれます。Shepi がエージェント用に入れる Herdr 自身のスキルにも、そこに別のスイッチがあります。エージェントの設定を消してしまったら、設定 › エージェント › もう一度セットアップ で、すべてのマシンに元どおり戻せます。

• 最新モデルのClaude Code？CLAUDE_CODE_ENABLE_TODO_TOOLS=1を付けて起動しないと、タスクリストを持ちません。
• スクリーンショット、ほかのアプリ：Shepiに画面収録またはアクセシビリティを許可すると（設定 › プライバシー › Macのアクセス許可）、そのペインのエージェントにも許可されます。

検索と⌘E

• 単語の順序は自由で、頭文字でも探せます：fatでfix-flaky-auth-testが見つかります。
• 長い単語のタイプミスは許容され、その結果には「近い」と表示されます。"引用符"で囲むとフレーズに一致します。
• Returnでそこへ移動します。出力の結果では、⌘Gで次の一致へ進みます。

スクリーンショットとファイル

1. スクリーンショット（⌃⇧⌘4）か、Finderでファイルをコピーします。
2. エージェントのペインで⌘Vを押すか、ファイルをドロップします。
3. エージェントにはパスが渡ります。サーバ上なら、Shepiが先にファイルをそこへコピーします。

1度に32 MBまで、フォルダは不可。Shepiが作ったコピーは7日後に削除され、元のファイルには一切触れません。

選択、コピー、リンク

ほかのマシンのエージェント

1. サイドバーの下にあるマシンを追加をクリックします。
2. SSHでの接続先を入力します：you@server、または~/.ssh/configのホスト。
3. Shepiでターミナルが開きます。ホストを信頼し、求められたらパスフレーズを入力すると、必要に応じてHerdrがそこにインストールされます。マシンはサイドバーに表示されます：ヘッダの下にスペースが並び、ヘッダをクリックすると折りたためます。マシンごとに色付きのマークがあり、このMacのものは「ローカル」と呼ばれ、エージェントの行にはそれぞれのマシン名が出ます。

問題のあるマシンはヘッダに!が付きます。その下、スペースが表示されているところに、理由と「再接続」があります。エージェントは動き続けます。

Gitと差分

ステージやコミットは一切しません。それはあなたか、エージェントの仕事です。

Worktree

worktreeは専用のブランチを持つ2つ目のチェックアウトで、2つのエージェントがファイルを共有せずに済みます。

1. リポジトリのペインで⇧Gを押します。Returnで提案されたブランチになります。2つのリポジトリにペインがあるときは、「作成元」でどちらかを選びます。
2. 独立したスペースとして開きます。そこでエージェントを開始します。
3. マージされると、ペインに「マージ済み · worktreeを削除しますか？」と表示されます。「削除」をクリックします。

マクロ

1つのキーで一連の入力を代わりに行い、メニューごとに待ちます。エージェントのモデルの切り替えや、サーバの再起動などです。いちばん簡単なのはエージェントに頼むこと（「Sonnetに切り替えるキーを作って」）。エージェントがマクロを書き、テストして、キーを教えてくれます。手で書くなら：

1. 設定 › マクロ › +。ステップを書きます：type、press、wait for（あるテキスト、またはプログラムの終了後ならthe shell）、pause。
2. キーを割り当て、必要なら実行対象のエージェントを1つに絞ります。
3. ペインでそのキーを押すか、⌘Fから実行します。Escで止まります。

マクロの書き方に、すべてのステップとレシピがあります。

設定

ShepiはMacの言語（英語、日本語、簡体字中国語）で表示されます。Shepiだけ別の言語にするには、設定 › 一般 › 言語で選びます。ターミナル、エージェント、コマンドはそのままです。

終了して戻る

Shepiの終了やMacの再起動はいつでもかまいません。エージェントはHerdrが動かし続け、サーバ上ならMacのスリープ中も作業を続けます。Shepiを開くか、切れた接続が戻ると、同じマシン、スペース、タブ、ペインに戻ります（ズームしていればズームしたまま）。そのどれかがなくなっていれば、Shepiはいちばん近いものを開き、何が変わったかを伝えます。

作業中のものを閉じる

作業中のエージェントがいるペイン、タブ、スペースを閉じようとすると、その上で確認されます：⌘Wで閉じ、Escで残します。アイドルのエージェントとシェルはすぐに閉じます。

トライアル、購入、アップデート

購入後の返金はできないので、14日間で判断してください：返金ポリシーを参照。

フィードバック

1. ヘルプ › フィードバックを送信…、またはサイドバー下部の吹き出し。
2. 何が起きたかを書き、役に立つならスクリーンショットを貼り付けます。
3. 診断ログをオンのまま「送信」を押します。伝えるためのレポートIDが表示されます。

ログにターミナルの内容、名前、パスが含まれることはありません。またはsupport@shepi.appに書いてください。詳しくはサポートページにあります。

解決法

すべてのキー

プレフィックスの後のキーはHerdrのデフォルトです（?で自分のキーを表示）。⌘のキーとa、d、⇧BはShepiのキーです。どのキーにも覚えるための単語があり、点の後に書いてあります：aはattentionのa。