Skip to content
Apothem
Adaptor harness

Adaptor harness

Adaptor harness Apothem — satu profil bersama, tujuh belas target yang didukung.

Apothem menyertakan tujuh belas adaptor harness bawaan. Setiap adaptor menerjemahkan kohor bersama yang sama menjadi berkas native-platform di tempat platform mendukungnya dan pohon pendukung milik-Apothem di tempat yang tidak.

Harness yang didukung

Registri yang didukung berisi tepat tujuh belas adaptor. Gunakan nama instal yang tepat ini dengan --harness, atau gunakan all untuk himpunan registri deterministik:

antigravity
claude-code
codebuddy
codex
cursor
gemini-cli
github-copilot
glm
hermes
kimi-code
kiro
open-claw
opencode
qwen-code
trae
windsurf
zed

Matriks registri terperinci, jalur target, status kapabilitas, dukungan MCP, dan bukti convention-pin berada di referensi registri teknis.

Instal beberapa harness

Instal satu harness, atau gunakan all untuk memilih registri dalam urutan deterministik. Harness cakupan-proyek memerlukan --project PATH; itu termasuk all karena registri mencakup target cakupan-pengguna maupun cakupan-proyek.

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

Verifikasi instalasi Anda

Verifikasi setiap adaptor harness satu per satu, atau panggil apothem doctor untuk ringkasan status-instal per-adaptor di seluruh adaptor yang terdaftar:

apothem verify --harness claude-code
apothem verify --harness all --project /path/to/project
apothem doctor

Cara kerja adaptor

Setiap adaptor mengimplementasikan protokol HarnessAdapter yang terdaftar melalui entry-point setuptools. Saat instalasi, CLI memuat dan memvalidasi profil YAML bersama, me-resolve adaptor melalui registri, memvalidasi rencana materialisasi, dan menulis konfigurasi native-platform ke lokasi pengguna atau proyek native harness. Saat pemutakhiran, ia menurunkan-ulang dari state profil saat ini.

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}/
         +-- ...

Skill di direktori home pengguna Anda

Tujuh adaptor berlingkup proyek menulis satu berkas aturan ke dalam proyek Anda (enam di antaranya juga menulis helper Apothem di sana sebagai berkas subagent; setiap halaman harness menyebutkan foldernya), dan adaptor tersebut juga menulis skill Apothem, beserta aturan dan templat yang dikutip skill tersebut, ke folder di direktori home pengguna Anda:

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)
  • Setiap instalasi yang menyebut sebuah folder menulis berkas yang sama, sehingga urutan pemasangan Anda tidak berpengaruh, dan satu salinan melayani semua proyek.
  • Instalasi menulis folder home lebih dulu. Jika itu gagal, instalasi berhenti sebelum mengubah proyek, dan tidak menambahkan berkas skill atau aturan ke repositori Anda.
  • Pencopotan menghapus folder bersama hanya ketika tidak ada lagi instalasi Apothem lain yang memakainya, dan menyebutkan instalasi mana yang mempertahankannya.
  • Folder skill dengan nama skill Apothem yang tidak ditulis oleh Apothem dibiarkan, disertai peringatan.

Setiap halaman harness mencantumkan foldernya. Registri harness menunjukkan alat mana yang berbagi folder mana.

Lihat Abstraksi adaptor harness untuk spesifikasi protokol.

On this page