OpenCode

Anbieter: OpenCode Installationsname: opencode Status: Beta Native Konfiguration: ~/.config/opencode/

InstallationCopy Anchor Link

apothem install --harness opencode

Der Adapter schreibt die JSON-Konfiguration von OpenCode, installiert Apothem-Skills in die Skill-Oberfläche von OpenCode, konvertiert Command-Prompts in Markdown-Command-Dateien von OpenCode und normalisiert Apothems Helferdefinitionen als OpenCode-Subhelfer.

Geschriebene Dateien:

~/.config/opencode/opencode.json
~/.config/opencode/apothem/rules/00-apothem-profile.md
~/.config/opencode/commands/
~/.config/opencode/skills/
~/.config/opencode/agents/
~/.config/opencode/.apothem/support/{rules,templates,hooks}/

Zuordnung von Profil zu nativer KonfigurationCopy Anchor Link

Der Adapter rendert opencode.json mit einer instructions-Dateiliste, die Ihr Profildokument, die vier Kernregeln und den Regelindex nennt, und propagiert dann jede gemeinsame Apothem-Kohorte entweder in eine native OpenCode-Oberfläche oder in einen Apothem-eigenen Unterstützungs-Teilbaum. Bestehende übereinstimmende, von Apothem verwaltete Kindeinträge werden vor dem Ersetzen gesichert.

KompatibilitätshinweiseCopy Anchor Link

OpenCode führt jede Datei, die die instructions-Liste nennt, in jeder Sitzung zusammen (OpenCode-Regeln). Die Liste nennt daher zuerst Ihr Profildokument und danach nur die Regeln, deren alwaysApply den Wert true hat, jeweils mit einem expliziten Pfad ~/.config/opencode/.apothem/support/rules/<name>.md; OpenCode löst das führende ~/ gegen Ihr Home-Verzeichnis auf. Diese Regeln sind agnostic-posture, authority-inquiry, context-management, session-closure und der Regelindex, apothem-rule-index. OpenCode beschränkt keine Regel auf Pfade, daher wird jede andere Regel bei Bedarf gelesen. Sie bleibt als Referenzmaterial unter ~/.config/opencode/.apothem/support/ installiert, und der Index nennt jede Regel und die Situation, die sie erfordert. Eine Regel, ein Skill oder ein Command, die bzw. der eine Regel, ein Template oder einen Hook-Prompt zitiert, liest sie bzw. es von dort. Commands, Skills und Helferdefinitionen nutzen native Discovery-Speicherorte.

Das Profildokument ~/.config/opencode/apothem/rules/00-apothem-profile.md trägt Ihre Identität und Ihre Präferenzen aus dem gemeinsamen Profil und endet mit einem Abschnitt zu den Apothem-Unterstützungsdateien, der das absolute Verzeichnis unter ~/.config/opencode/.apothem/support/ nennt, gegen das jedes Zitat im Repository-Stil (rules/<name>.md, templates/..., hooks/...) aufgelöst wird. Es ist der erste instructions-Eintrag, daher lädt OpenCode es in jeder Sitzung.

Eine von einem früheren Release geschriebene opencode.json listet den einzelnen Glob ~/.config/opencode/.apothem/support/rules/*.md, der jede Regel lädt, oder einen expliziten Pfad für jede der 28 Regeln, die damals stets aktiv waren. apothem install und apothem update ersetzen beide Formen durch die obige Liste, was die 24 Pfade entfernt, die beim Start nicht mehr geladen werden, und apothem uninstall entfernt sie alle. Ihre eigenen instructions-Einträge bleiben in jedem Fall erhalten.

VerifizierungCopy Anchor Link

apothem verify --harness opencode

Der Befehl verify bestätigt Folgendes:

1. Die native Konfiguration existiert am erwarteten Pfad.
2. Jedes verwaltete Ziel existiert; verwaltete Dateien sind nicht leer, und JSON- oder YAML-Konfigurationen lassen sich parsen. Fügen Sie --profile PATH hinzu, um außerdem zu bestätigen, dass die installierten Dateien zu diesem Profil passen.
3. Die adapterspezifische Verifizierungsroutine meldet Erfolg.

AktualisierungCopy Anchor Link

apothem update --harness opencode

Aktualisiert opencode.json, native Commands, Skills, Helferdefinitionen und den Apothem-Unterstützungs-Teilbaum.

DeinstallationCopy Anchor Link

apothem uninstall --harness opencode

Entfernt die Einträge, die der Adapter zu ~/.config/opencode/opencode.json hinzugefügt hat (Ihre eigenen Schlüssel, MCP-Server und instructions-Einträge bleiben erhalten, und die Datei wird nur gelöscht, wenn Apothem sie angelegt hat und nichts von Ihnen übrig ist). Entfernt den Apothem-Block aus dem Profildokument ~/.config/opencode/apothem/rules/00-apothem-profile.md und behält jeden anderen Text darin; diese Datei wird nur gelöscht, wenn darin nichts anderes mehr übrig ist. Entfernt außerdem die Apothem-Dateien in ~/.config/opencode/commands/, ~/.config/opencode/skills/, ~/.config/opencode/agents/ und ~/.config/opencode/.apothem/support/; andere Dateien in diesen Ordnern bleiben bestehen. Jede Datei wird unter ~/.apothem/backups/ gesichert, bevor sie geändert oder entfernt wird. Die YAML-Datei des gemeinsamen Profils und die Apothem-Engine bleiben unberührt.

Konformitäts-GateCopy Anchor Link

python -m apothem.conformity.gate --all .

FehlerbehebungCopy Anchor Link

KonfigurationsschalterCopy Anchor Link

Siehe auchCopy Anchor Link

• Alle Harnesses — der vollständige Katalog der unterstützten Werkzeuge
• Installationsanleitung — Apothem in diesen Harness installieren
• Referenz zu apothem harnesses — Adapter über die CLI auflisten und untersuchen