ハーネスアダプター
Apothem のハーネスアダプター — 1 つの共有プロファイル、17 のサポート対象ターゲット。
Apothem は 17 個の組み込みハーネスアダプターを提供します。各アダプターは、同じ共有コホートを、 プラットフォームがサポートする場合はプラットフォームネイティブのファイルへ、サポートしない 場合は Apothem 所有のサポートツリーへと変換します。
サポート対象ハーネス
サポート対象のレジストリには、ちょうど 17 個のアダプターが含まれます。--harness には以下の
正確なインストール名を使用するか、決定的なレジストリセットには all を使用します。
antigravity
claude-code
codebuddy
codex
cursor
gemini-cli
github-copilot
glm
hermes
kimi-code
kiro
open-claw
opencode
qwen-code
trae
windsurf
zed詳細なレジストリマトリクス、ターゲットパス、機能の状態、MCP サポート、規約ピンの根拠は、 技術レジストリリファレンスにあります。
複数のハーネスをインストールする
1 つのハーネスをインストールするか、all を使ってレジストリを決定的な順序で選択します。
プロジェクトスコープのハーネスには --project PATH が必要です。レジストリにはユーザースコープと
プロジェクトスコープの両方のターゲットが含まれるため、all もこれに該当します。
apothem install --harness claude-code
apothem install --harness cursor --project /path/to/project
apothem install --harness gemini-cli --project /path/to/project
apothem install --harness all --project /path/to/projectインストールを検証する
各ハーネスアダプターを個別に検証するか、登録済みのすべてのアダプターにわたるアダプターごとの
インストール状況のサマリーを得るために apothem doctor を呼び出します。
apothem verify --harness claude-code
apothem verify --harness all --project /path/to/project
apothem doctorアダプターの仕組み
各アダプターは、setuptools のエントリーポイント経由で登録された HarnessAdapter プロトコルを
実装します。インストール時、CLI は共有 YAML プロファイルを読み込んで検証し、レジストリを通じて
アダプターを解決し、マテリアライズ計画を検証し、プラットフォームネイティブの設定をハーネスの
ネイティブなユーザーまたはプロジェクトの場所に書き込みます。更新時には、現在のプロファイルの
状態から再導出します。
profile.yaml + packaged cohorts
identity / preferences / rules
commands / skills / delegated definitions / hooks / templates
|
+-- antigravity --> ~/.gemini/GEMINI.md + ~/.gemini/antigravity-cli/plugins/apothem/
+-- claude-code --> ~/.claude/ native folders + ~/.claude/.apothem/support/
+-- codex --> ~/.codex/ + ~/.agents/skills/ + ~/.config/apothem/{rules,templates}/
+-- cursor --> <project>/.cursor/rules/*.mdc + <project>/.cursor/agents/ + ~/.agents/skills/ + ~/.config/apothem/{rules,templates}/
+-- gemini-cli --> <project>/GEMINI.md + <project>/.gemini/
+-- github-copilot --> <project>/.github/copilot-instructions.md + <project>/.github/agents/ + ~/.agents/skills/ + ~/.config/apothem/{rules,templates}/
+-- windsurf --> <project>/.devin/rules/ + <project>/.devin/agents/ + ~/.agents/skills/ + ~/.config/apothem/{rules,templates}/
+-- ...ユーザーホーム内のスキル
プロジェクトスコープの 7 つのアダプターは、プロジェクトにルールファイルを 1 つ書き込み（そのうち 6 つは Apothem のヘルパーもサブエージェントファイルとしてそこに書き込みます。各ハーネスのページがそのフォルダーを 挙げています）、さらに Apothem のスキルと、スキルが引用するルールとテンプレートを、あなたのユーザーホーム内の フォルダーに書き込みます。
cursor, github-copilot, windsurf, zed -> ~/.agents/skills/ (codex writes it too)
codebuddy -> ~/.codebuddy/skills/
kiro -> ~/.kiro/skills/
trae -> ~/.trae/skills/
all seven -> ~/.config/apothem/rules/ and templates/ (codex uses them too)- フォルダーを指定するすべてのインストールが同じファイルを書き込むため、インストールの順序は関係なく、 1 つのコピーがすべてのプロジェクトに使われます。
- インストールはホームのフォルダーを最初に書き込みます。それが失敗した場合、プロジェクトを変更する前に 停止し、あなたのリポジトリにスキルファイルもルールファイルも追加しません。
- アンインストールは、それをまだ使っている他の Apothem のインストールがない場合にのみ共有フォルダーを削除し、 どのインストールがそれを残しているかを表示します。
- Apothem のスキルの名前を持ち、Apothem が書き込んだのではないスキルフォルダーは、警告とともにそのまま 残されます。
各ハーネスのページが、そのフォルダーを一覧にしています。 ハーネスレジストリは、どのツールがどのフォルダーを 共有しているかを示しています。
プロトコルの仕様についてはハーネスアダプター抽象化を 参照してください。