アンインストール
Apothem を削除し、ハーネス設定をクリーンアップします。
最初にハーネス設定を削除する
このページで使われている素の apothem コマンドは、ワンショットインストーラー(インストールガイドのチャネル 3)が書き込むシムです。そのシムのディレクトリが PATH に含まれていれば実行できます。その他のインストールチャネルでは、インストールガイドに記載されているとおり、apothem を npx @ahmed-g-gad/apothem に置き換えてください。
Apothem をアンインストールする前に、各ハーネスアダプターの設定を削除して、ハーネスをクリーンな状態にしておきます。
apothem harnesses list を実行して現在どのアダプターがインストールされているかを確認し、それらを 1 つずつ削除するか、レジストリ全体のセレクターを使用します。
apothem uninstall --harness claude-code
apothem uninstall --harness cursor --project /path/to/project
apothem uninstall --harness all --project /path/to/project --yesハーネスごとの確認プロンプトをスキップするには --yes を渡します。
エンジンを削除する
削除方法は、使用したインストールチャネルに対応します。チャネル番号は、インストールチャネルの表のものです。
-
Claude Code プラグイン(チャネル 1) — Claude Code 内からプラグインを削除します:
/plugin uninstall apothem@apothem(マーケットプレイスのエントリーは/plugin marketplace remove ahmed-g-gad/apothemで削除できます)。 -
npx(チャネル 2) — 削除するものはありません。
npxはそのキャッシュから実行されます。キャッシュされたコピーを消去したい場合は、npm cache clean --forceを実行してください。 -
ワンショットインストーラー(チャネル 3) — チェックアウトから、対応するアンインストールスクリプトを実行します:POSIX では
scripts/installer/uninstall.sh、PowerShell ではscripts/installer/uninstall.ps1です。各スクリプトは、--harness(PowerShell では-Harness)で指定されたハーネスを削除します。指定がない場合はAPOTHEM_HARNESSを使い、それもない場合は Claude Code を削除します。apothemコマンドのシムも削除します。ソースは、APOTHEM_SOURCEが設定されていればそこから、そうでなければAPOTHEM_HOME(デフォルトは$HOME/.apothem)から取得されます。ソースは、--remove-source(PowerShell では-RemoveSource)を渡さない限り残ります。このフラグが削除するのはAPOTHEM_HOMEにある管理対象のクローンだけであり、それも.gitディレクトリがある場合に限られます。デフォルトの場所を使う場合は、~/.apothem/配下のインストールバックアップと台帳も削除されます。どちらのスクリプトも、ハーネス設定とソースを削除する前に確認を求めます。--yes(PowerShell では-Yes)を指定すると確認をスキップします。どちらも安全でない対象を拒否します。 -
VS Code 系拡張機能(チャネル 4) — まず、コマンドパレットから Apothem: Uninstall を実行してハーネス設定を削除します。その後、拡張機能ビューから、または
code --uninstall-extension ahmed-g-gad.apothem-vscodeで拡張機能を削除します(以前のapothem.vsixからインストールしたコピーはahmed-g-gad.apothemです)。デフォルトでは、拡張機能はnpxを介してエンジンを実行するため、キャッシュについては上の npx の項目が該当します。 -
コマンドラインのブートストラップ(チャネル 5–7) — ハーネス設定が削除された後で、ホストツールを使って拡張機能またはプラグインを削除します。ホストは次のとおりです:
channel 5 Gemini CLI extension channel 6 Qwen Code extension channel 7 Codex pluginブートストラップが追加するのは、
npxを介してエンジンを呼び出すアシスタントのコンテキスト(コンテキストファイル、コマンド、またはスキル)だけであるため、それ以外に残るものはありません。 チャネル 5 と 6 の拡張機能ホストにはアンインストールコマンドがあります。チャネル 7 のプラグインホストでは、そのプラグインブラウザーでapothemをアンインストールします。gemini extensions uninstall apothem # channel 5 qwen extensions uninstall apothem # channel 6 -
直接エンジン(チャネル 8) — アンインストールするものはありません。ハーネス設定を削除した後で、クローンを削除します。
-
バックアップと状態 — インストールのバックアップは
~/.apothem/backups/配下に、インストール台帳は~/.apothem/state/配下にあります。 どちらも上限内に保たれます。インストール、アンインストール、ロールバックのたびに、Apothem はインストールルートごとに最新 10 件のインストール記録と、ハーネスごとに最新 10 件のバックアップセットを保持し、保持された記録がまだ必要とするバックアップは決して削除しません。そのため、直近 10 回のインストールは引き続きロールバックできます。 保持数を減らすにはapothem backups prune --keep Nを実行します(何が削除されるかを先に確認するには--dry-runを追加します)。このコマンドは、ハーネスの最新のインストールをロールバックする際の復元元となるバックアップを決して削除しません。 エンジンを削除し、履歴がまったく不要になったら、~/.apothem/を削除してください。
削除されないもの
~/.config/apothem/profile.yamlまたは--profile PATHにある共有プロファイル YAML は、apothem uninstallによって削除されることは決してありません。- ハーネスディレクトリ内の、無関係なオペレーター作成のファイルは保持されます。
- 共有の設定ファイルにあなたが追加したエントリは保持されます。あなた自身の権限ルール、MCP サーバー、フックハンドラーはそのまま残ります。 アンインストールが削除するのは、インストール台帳が Apothem のものとして記録しているキーとリストエントリだけです(設定を参照)。
- インストールルートの
.apothem/配下にある共有データストア(memory/、contexts/、learning/)は、同じルートにある別のインストール済みハーネスがまだそれらを使用している間は残ります。 そのルートで最後のハーネスをアンインストールすると、各ストアをまず~/.apothem/backups/にコピーしてから、中身ごと削除します。 <project>/.apothem/plans/(およびレガシーの<project>/.plans/)配下のプランスイートは影響を受けません。
ディレクトリ
アンインストールは、インストールが作成したディレクトリ(たとえば、最初のインストールの前には存在しなかった ~/.claude/)も、空になった時点で削除します。
あなたのファイル、または別のインストール済みハーネスが使用するデータがまだ残っているディレクトリは、そのまま残ります。
インストールの前から存在していたディレクトリが削除されることは決してありません。
ハーネスルートを完全にクリーンアップするには、保持したいカスタムルール、ヘルパー、プロファイルファイルをバックアップしたことを確認したうえで、ハーネスリファレンスページに記載されているハーネスネイティブのパスを削除してください。