マクロ：キー1つで一連の操作を。
マクロは、今いるペインにあなたと同じように入力し、メニューごとに待ってから次へ進みます。エージェントのモデルの切り替え、開発サーバの再起動、いつもの3つのコマンド：1度書けば、あとはキー1つです。
どのペインのエージェントにも、普段の言葉で頼んでください。マクロを作り、試して、キーを割り当てます。あとから変更や削除もできます。
ほかにも：「再起動マクロで先に画面をクリアして」「テストのマクロに ⌥⌘T を割り当てて」「使っていないマクロを削除して」。
マクロの見た目
マクロとは、手でやることを書き留めたものです。1行に1つの動作で、上から順に実行します。これはClaude Codeを別のモデルに切り替えるものです。各行とその動作：
マクロとはこれだけです。Shepiは今いるペインで、入力しているかのように各行を順に実行します。
マクロを実行する
マクロは、開始時にフォーカスのあるペインに入力します。このMacでもほかのマシンでも同じで、あなたが移動してもそのペインのままです。実行中はステータスラインに「実行中…」と表示され、入力はいつもどおり届き、escで止まります。終わっても何も知らせず、ペインに結果が表示されます。オフラインのマシンに入力することはありません。どのマクロにも、エディタの名前の横に短いIDがあり、コピーできます。名前が同じマクロが2つあっても、エージェントはIDで実行できます。
キーと対象
- キー：プレフィックスのあとの任意のキー（⌃B mなど）、または⌘付きのショートカット（⌥⌘1など）。Herdr、Shepi、macOSがすでに使っているキーや、ほかのマクロのキーは受け付けません。あとでHerdrがマクロのキーを使い始めたらHerdrが優先され、マクロは別のキーを選ぶよう伝えます。
- 対象：マクロをClaude Codeのような1つのエージェント、または普通のシェルに限定します。ほかのペインでは、キーは何もせず、そう伝えるだけです。
マクロが止まったら
| 「…が表示されませんでした」 | wait forがタイムアウトしました：メニューに時間がかかったか、テキストが違います。手でテキストを確かめてください。遅いだけならup to 10 sを加えます。 |
| 「シェルに戻りませんでした」 | wait for the shellがタイムアウトしました：プログラムがまだ動いているか、終了前に何か質問しています。ペインを見てください。終了が遅いだけならup to 15 sを加えます。 |
| 「Escで停止しました」 | escを押しました。それ以上は何も入力されていません。 |
| 「リポジトリ内ではありません」「何も選択されていません」 | マクロが使う値が、このペインにはありません。何も入力されていません。その値があるところで実行します。 |
| 「…はオフラインです」 | マシンが接続されていません。サイドバーから再接続します。 |
| 「Claude Code用です」 | マクロは別の種類のペインに限定されています（対象）。 |
エディタで赤くなった行には、何が問題かが表示されます。すべての行が正しくなるまで何も実行されません。
HerdrのターミナルUIでも
Herdr自身のターミナルUIも使っているなら、エディタの「その他」セクションにあるHerdrの設定用にコピーで、マクロをHerdrのカスタムコマンドとしてコピーできます。Herdrの設定には自分で貼り付けてください。Shepiがそのファイルを編集することはありません。