適用範囲

ホストが提供する接管入口は 1 つではなく、到達範囲と反映タイミングがそれぞれ異なります。どの層までカバーするかを決めてからチャネルを選びます。

4 つのチャネル

チャネル	役割	反映タイミング
install	ホストの管理設定やプラグインを書き込む	静的設定は新規セッション、読み込み済みの動的プラグインは次ターン
shim	PATH 上の同名コマンド経由で起動を転送	そのコマンドからの次回起動
slash	セッション内 /purge 拡張を導入	ホスト拡張の有効状態に依存
project	指定ディレクトリのプロジェクトルールファイルを書き込む	そのディレクトリの新規セッション

agent-purge install codex
agent-purge arm pi --slash
agent-purge project on pi --dir /path/to/project
agent-purge status

arm <h> はそのホストで利用可能な常駐・コマンド・slash チャネルを順に試し、結果を項目ごとに報告します。プロジェクトチャネルは別途指定します。同じペルソナが複数入口から供給されると重複するため、必要な範囲だけを有効化してください。

単発利用

一度だけ使いたい場合は、常駐チャネルを登録せず agent-purge 経由で起動します：

agent-purge codex --mode append
agent-purge pi --ask "このコードを説明して"
agent-purge codex -- --help          # -- 以降の引数はホストへ渡されます

反映タイミングが違う理由

• セッション内ホットスイッチ（command / state）：毎ターン system を再構築します。Pi、pi-desktop、omp は before_agent_start フック、OpenCode と dsh は毎ターン状態を読むプラグインを使います。設定変更は次ターンで反映されます。
• 新規セッションが必要：system は起動時に一度だけ構築されます。Claude、Codex、Grok、Kiro、Antigravity などが該当し、変更後はセッションを開き直す必要があります。

ホスト別のホットスイッチ可否は対応状況にあります。

プロジェクトルールの共有

同じルールをディレクトリ単位でホストのルールファイルに書き込めます。「このリポジトリは簡潔な文体、他は既定のまま」といった使い方に向きます。書き込み前の diff プレビューと、解除時の元バイト復元に対応します。

magpie ゲートウェイ

magpie ゲートウェイを使う場合、任意プラグインはリポジトリの magpie-plugin/ ディレクトリにあり、リポジトリ直下ではありません。導入手順とゲートウェイ側の書き換え境界は同ディレクトリの README に記載しています。