Harness-Adapter

Apothem liefert siebzehn integrierte Harness-Adapter aus. Jeder Adapter übersetzt dieselben gemeinsamen Kohorten in plattformnative Dateien, wo die Plattform sie unterstützt, und in Apothem-eigene Unterstützungs-Teilbäume, wo dies nicht der Fall ist.

Unterstützte HarnessesCopy Anchor Link

Die unterstützte Registry enthält genau siebzehn Adapter. Verwenden Sie diese exakten Installationsnamen mit --harness oder verwenden Sie all für die deterministische Registry-Menge:

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

Die detaillierte Registry-Matrix, Zielpfade, Fähigkeitszustände, MCP-Unterstützung und Konventions-Pin-Belege finden Sie in der technischen Registry-Referenz.

Mehrere Harnesses installierenCopy Anchor Link

Installieren Sie einen einzelnen Harness oder verwenden Sie all, um die Registry in deterministischer Reihenfolge auszuwählen. Harnesses mit Projektbereich erfordern --project PATH; das schließt all ein, weil die Registry sowohl Ziele mit Benutzerbereich als auch mit Projektbereich enthält.

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

Ihre Installationen überprüfenCopy Anchor Link

Überprüfen Sie jeden Harness-Adapter einzeln oder rufen Sie apothem doctor für eine Installationsstatus-Zusammenfassung pro Adapter über jeden registrierten Adapter hinweg auf:

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

Wie Adapter funktionierenCopy Anchor Link

Jeder Adapter implementiert das HarnessAdapter-Protokoll, das über setuptools-Entry-Points registriert ist. Bei der Installation lädt und validiert die CLI das gemeinsame YAML-Profil, löst den Adapter über die Registry auf, validiert den Materialisierungsplan und schreibt die plattformnative Konfiguration an den nativen Benutzer- oder Projektort des Harness. Bei einem Update leitet sie aus dem aktuellen Profilzustand neu ab.

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

Skills in Ihrem Home-VerzeichnisCopy Anchor Link

Sieben Adapter mit Projektgeltungsbereich schreiben eine Regeldatei in Ihr Projekt (sechs von ihnen schreiben dort außerdem die Helfer von Apothem als Subagenten-Dateien; jede Harness-Seite nennt den Ordner), und sie schreiben außerdem die Skills von Apothem sowie die Regeln und Templates, auf die die Skills verweisen, in Ordner in Ihrem Home-Verzeichnis:

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)

• Jede Installation, die einen Ordner nennt, schreibt dieselben Dateien, daher spielt die Reihenfolge Ihrer Installationen keine Rolle, und eine einzige Kopie dient allen Projekten.
• Eine Installation schreibt die Home-Ordner zuerst. Schlägt das fehl, bricht sie ab, bevor sie das Projekt ändert, und sie fügt Ihrem Repository keine Skill- oder Regeldatei hinzu.
• Eine Deinstallation entfernt einen gemeinsam genutzten Ordner nur, wenn keine andere Apothem-Installation ihn noch nutzt, und sagt, welche Installation ihn behält.
• Ein Skill-Ordner mit dem Namen eines Apothem-Skills, den Apothem nicht geschrieben hat, bleibt unangetastet, mit einer Warnung.

Jede Harness-Seite listet ihre Ordner auf. Die Harness-Registry zeigt, welche Werkzeuge welchen Ordner teilen.

Die Protokollspezifikation finden Sie unter Harness-Adapter-Abstraktion.