Schnellstart

Dies ist der schnelle Weg von null zu einer verifizierten Harness-Konfiguration: installieren, das gemeinsame Profil verfassen, die native Konfiguration eines Werkzeugs materialisieren, sie bestätigen und Ihre erste Bearbeitung vornehmen. Jeder Befehl ist echt und lässt sich per Kopieren und Einfügen ausführen, und jeder Schritt zeigt, was ein sauberer Lauf ausgibt. Die Installation selbst ist in weniger als zwei Minuten erledigt; das Bearbeiten des Profils ist der einzige Teil, der so lange dauert, wie Sie möchten.

Am Ende haben Sie eine funktionierende Harness-Konfiguration, die aus einem von Ihnen geschriebenen Profil erzeugt wurde — und Sie kennen den einen Befehl, der eine Profiländerung wieder an ein einzelnes Werkzeug oder an alle Werkzeuge ausspielt.

Sie verwenden Claude Code als Beispiel-Harness — es ist die Voreinstellung des Installers. Tauschen Sie bei jedem Schritt den Adapternamen aus, um ein anderes Werkzeug anzusprechen; die Harness-Liste enthält jeden unterstützten Namen.

1. Apothem installierenCopy Anchor Link

Apothem wird als eigenständige Laufzeit ausgeliefert — die Engine läuft direkt aus ihrem Quellbaum mit vendorten Abhängigkeiten. Ein einziger Befehl holt den Quellcode, legt die Engine ab und materialisiert Ihren ersten Harness. Er prüft zuerst das signierte Release. Importieren Sie daher den Maintainer-Signaturschlüssel vor der ersten Installation einmalig und prüfen Sie, dass der Fingerabdruck 5C89 98F9 F241 7204 45D3 F28B 7039 6FED 9C63 4163 lautet:

curl -fsSL https://github.com/ahmed-g-gad.gpg | gpg --import
gpg --fingerprint 70396FED9C634163

& "$env:ProgramFiles\Git\bin\bash.exe" -c 'curl -fsSL https://github.com/ahmed-g-gad.gpg | gpg --import && gpg --fingerprint 70396FED9C634163'

Führen Sie anschließend den Installer aus:

curl -fsSL https://apothem.ahmedgad.com/install.sh | bash

irm https://apothem.ahmedgad.com/install.ps1 | iex

Der Installer setzt ein System-Python 3.10+ voraus, dazu git und gpg für die Netzwerkform. Er prüft die Voraussetzungen und legt die Engine unter ~/.apothem ab. Fehlt click oder rich, installiert er das Paket nach Ihrer Bestätigung, bei Angabe von --yes (-Yes unter PowerShell) oder bei gesetztem APOTHEM_AUTO_INSTALL_DEPS=1; andernfalls bricht er mit dem auszuführenden pip-Befehl ab (siehe Voraussetzungen auf einen Blick). Nach Abschluss gibt er ein Banner mit den nächsten Schritten aus; unter POSIX sieht das Banner, wenn das Verzeichnis des Shims bereits im PATH liegt, so aus:

Installation complete.

The 'apothem' command is on your PATH.

Recommended first step — the guided setup (profile -> preview -> install):

  apothem quickstart

Die Installationsanleitung behandelt die anderen Installationswege — das Claude Code-Plugin (/plugin marketplace add ahmed-g-gad/apothem, dann /plugin install apothem@apothem); die Erweiterung für die VS Code-Familie und weitere werkzeugeigene Erweiterungen; und die npx-Form auf Abruf (npx @ahmed-g-gad/apothem <command>) — zusammen mit den Optionen über Umgebungsvariablen.

2. Das gemeinsame Profil erstellenCopy Anchor Link

apothem profile init schreibt das kleinste schemagültige Profil nach ~/.config/apothem/profile.yaml. Liegt dort bereits ein Profil, etwa weil der Installer in Schritt 1 das Beispielprofil kopiert hat, bricht init mit einem Fehler ab und lässt die Datei unverändert; übergeben Sie --force, um sie zu überschreiben, oder behalten Sie die Datei und bearbeiten Sie sie wie unten gezeigt. Übergeben Sie --profile PATH, wenn Sie ein projekt- oder CI-spezifisches Profil an anderer Stelle führen.

apothem profile init
apothem profile show --json

Das Gerüst verwendet fiktive Platzhalter-Identitätsdaten und kann gefahrlos bearbeitet werden, bevor Sie irgendeine Harness-Ausgabe installieren. show --json liest es zurück und meldet das validierte Profil mit allen ausgefüllten Standardwerten, beginnend mit schema_version. Der Befehl gibt es in einer Zeile aus; hier ist es aufgeklappt:

{
  "schema_version": 1,
  "identity": {
    "name": "Example User",
    "role": "senior software engineer",
    "email": "[email protected]",
    "github": "example-user"
  },
  "preferences": {
    "language": "python",
    "style": "concise"
  },
  "rules": [],
  "seriousness": "PERSONAL_USE",
  "enforcement": {
    "sprints": false,
    "agent_teams": false,
    "multitasking": false,
    "continuous_execution": false,
    "learning_loop": false
  },
  "mcp_servers": {},
  "agent_mcp_servers": {},
  "harnesses": {},
  "exclude_harnesses": [],
  "workspace": {
    "directory_name": ".apothem",
    "scope": "project-local"
  }
}

Hier zeigt sich auch eine fehlerhafte Bearbeitung — ist das YAML ungültig, meldet show dies an dieser Stelle, bevor irgendeine Harness-Konfiguration geschrieben wird. Machen Sie das Profil mit apothem profile edit (öffnet es in Ihrem Editor) zu Ihrem eigenen, oder setzen Sie einen einzelnen Schlüssel direkt:

apothem profile set identity.name "Your Name"

3. Harness-Adapter installierenCopy Anchor Link

Materialisieren Sie den Adapter für Ihren primären Harness. Dies liest Ihr Profil und schreibt die native Konfiguration dieses Werkzeugs:

apothem install --harness claude-code

✓ Installed claude-code -> /home/you/.claude/settings.json

Adapter mit Projektbereich schreiben ihre Regeldatei innerhalb eines Projekts und benötigen daher ein --project PATH; sieben von ihnen schreiben außerdem Skills und gemeinsame Regeln in Ordner in Ihrem Home-Verzeichnis, und --project ändert nicht, wohin diese geschrieben werden. Mit --dry-run sehen Sie jede Installation in einer Vorschau, ohne Dateien zu schreiben:

apothem install --harness cursor --project . --dry-run
apothem install --harness cursor --project .

Installieren Sie den gesamten durch die Harness-Registry gestützten Satz auf einmal mit --harness all. Da diese Auswahl sowohl Dateien im Projektbereich als auch Dateien im Benutzerbereich schreibt, gibt der Befehl die konkreten Ziele nach Ort gruppiert aus. In einem interaktiven Terminal fragt er nach, bevor er außerhalb der Projektwurzel schreibt. Ein Lauf ohne Terminal, ein Lauf mit --yes oder ein Lauf mit --format json schreibt ohne Nachfrage; --dry-run schreibt nichts. Führen Sie den vollständigen Satz so aus:

apothem install --harness all --project .

Jeden unterstützten Namen finden Sie in der vollständigen Harness-Liste, den vollständigen Optionssatz in der install-Referenz.

4. VerifizierenCopy Anchor Link

Das Materialisieren ist nur die halbe Arbeit: verify bestätigt, dass die erwarteten Konfigurationsdateien des Harness angekommen und gültig sind:

apothem verify --harness claude-code

✓ claude-code is verified at /home/you/.claude/settings.json

verify endet mit einem Code ungleich null, wenn ein verwaltetes Ziel fehlt, eine verwaltete Datei leer ist oder eine JSON- oder YAML-Konfiguration nicht geparst werden kann. Fügen Sie --profile PATH hinzu, damit die Prüfung außerdem fehlschlägt, wenn sich eine installierte Datei von diesem Profil unterscheidet; damit wird verify zu einer Drift-Prüfung. Ohne diese Angabe besteht eine veraltete Konfiguration die Prüfung weiterhin. Der Exit-Code ungleich null erlaubt es, verify als Gate in einem Einrichtungsskript einzusetzen. Für eine Zustandsprüfung der gesamten Maschine über jeden registrierten Adapter führen Sie Folgendes aus:

apothem doctor

doctor prüft jeden installierten Harness: Er muss die Verifizierung bestehen, und jeder Hook-Befehl, den seine Installation registriert hat, muss starten. Ein Harness, den Sie nicht installiert haben, wird aufgeführt, gilt aber nicht als Fehlschlag, sodass doctor mit Exit-Code 0 endet, wenn keine Prüfung fehlschlägt, auch wenn nur ein einziger Harness installiert ist.

5. Ihr erster LaufCopy Anchor Link

Öffnen Sie den Harness, den Sie gerade konfiguriert haben — in diesem Beispiel Claude Code —, und starten Sie eine Sitzung in einem beliebigen Projekt. Das Profil, das Sie in Schritt 2 eingerichtet haben, ist nun Teil des Verhaltens dieses Werkzeugs. Das ist der funktionierende erste Lauf: ein Profil, das eine echte Sitzung prägt.

Wenn Sie das Profil später ändern, wenden Sie es erneut an, ohne neu zu installieren:

apothem update --harness claude-code

Nennen Sie einen anderen Adapter, um das Profil erneut auf dieses Werkzeug anzuwenden (fügen Sie bei einem Adapter mit Projektbereich --project PATH hinzu), oder übergeben Sie --harness all --project ., um es erneut auf jeden unterstützten Harness anzuwenden.

Nächste SchritteCopy Anchor Link

• Weitere Harnesses hinzufügen — wiederholen Sie Schritt 3 für jedes Werkzeug.
• Ihre erste Regel schreiben — die Einheit, die jeder Harness erbt.
• Einen Plan verfassen — führen Sie eine ganze Mission durch die deterministische Plan-Pipeline.
• CLI-Referenz — jeder Befehl, jedes Flag und jeder Exit-Code.