ZiChuanLan/agent-purge

これは何？

主な機能

• 01設定ブロック、PATH上のshim、セッション中のコマンドを使って、複数のコーディングエージェントに1つのペルソナを設定。
• 02replace、strict、append、offの各モードを実行中に切り替え可能。
• 03ペルソナの一覧表示、ハーネスの状態確認、注入の切り替えができるローカルWebコンソール。
• 04アンインストール、無効化、offへの切り替えで、加えた変更をすべて元に戻せる。
• 05オプションのmagpieゲートウェイプラグインにより、ゲートウェイを通るリクエストのシステムプロンプトを書き換え可能。

ユースケース

• Claude Code、Codex、OpenCodeで、ペルソナやコーディングスタイルを統一する。
• 異なるシステムプロンプトがコーディングエージェントの動作に与える影響を試す。
• 複数のエージェントをローカルゲートウェイ経由でルーティングし、ペルソナを1か所で変更する。

クイックスタート

1. 1

   npm経由でCLIをグローバルにインストールする

   npm i -g agent-purge
2. 2

   ローカルのWebコンソールを起動する

   agent-purge web
3. 3

   現在のペルソナでコーディングエージェントを起動する（例：codex）

   agent-purge codex

使う前に知っておきたいこと

• !Node.js 20以降が必要です。
• !クローズドソースのデスクトップエージェントはそのまま起動され、プロンプトを挿入することはできません。
• !オプションのmagpieゲートウェイプラグインはgit cloneでインストールする必要があります。また、変更後はペルソナ一覧を再生成する必要があります。
• !strictモードとreplaceモードでは、ツールの指示が削除される可能性があるため、ハーネスの動作が低下または変化することがあります。

収録されている特集

トピック

よくある質問

agent-purge とは？

Claude Code、Codex、OpenCodeなど複数のコーディングエージェントで、共通のシステムプロンプト（ペルソナ）を注入・置換するローカルWebコンソールとCLI。 agent-purgeを使うと、codex、claude、opencode、pi、hermesなど複数のコーディングエージェントのハーネスに、1つのペルソナファイルをシステムプロンプトとして設定できます。ハーネスごとにシステムプロンプトの読み込み場所が異なるため、このツールでは3つの方法を用意しています。ハーネスに管理対象の設定ブロックを追加する方法、PATH上のshimからペルソナ付きでハーネスを起動する方法、セッション中にスラッシュコマンドで有効・無効を切り替える方法です。モードはreplace、strict（ペルソナのみ）、append、offの4種類です。

agent-purge は無料で使えますか？ライセンスは？

agent-purge は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

agent-purge は今もメンテナンスされていますか？

活発にメンテナンス中。agent-purge の最終コミットは 2026年11月6日 です。

agent-purge は何に使えますか？

Claude Code、Codex、OpenCodeで、ペルソナやコーディングスタイルを統一する。 異なるシステムプロンプトがコーディングエージェントの動作に与える影響を試す。 複数のエージェントをローカルゲートウェイ経由でルーティングし、ペルソナを1か所で変更する。

agent-purge のインストール方法は？

npm経由でCLIをグローバルにインストールする: npm i -g agent-purge ローカルのWebコンソールを起動する: agent-purge web 現在のペルソナでコーディングエージェントを起動する（例：codex）: agent-purge codex

agent-purge はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/ZiChuanLan/agent-purge