Codex

Voraussetzungen

Verwenden Sie OpenAI Codex CLI oder Codex Desktop mit Streamable HTTP MCP und Unterstützung für die Skill-Ausführung:

• Konkrete Schnittstelle: Codex CLI und Codex Desktop (codex).
• Laufzeitanforderung: Node.js-Version 22.22.0 oder höher für den eigenständigen Skill-Runner.
• Konto: Gültiges XMemo-Konto unter https://xmemo.dev.
• MCP-Voraussetzung: Unterstützung für bearer_token_env_var in ~/.codex/config.toml.

Installation / Einrichtung

Der empfohlene Pfad installiert den eigenständigen XMemo-Skill über den vom Eigentümer ausgewählten Prompt in das Skills-Verzeichnis von Codex. Bitten Sie Ihren Agenten in Codex, die Installation auszuführen:

• Prompt: Install the standalone XMemo Skill into your skills directory: run the installer from https://xmemo.dev/skill/install (on Windows, https://xmemo.dev/skill/install.ps1) with XMEMO_SKILL_DIR set to your skills directory plus /xmemo-memory. Run the doctor command it prints to verify the installation, then reload your skills and follow the Skill's first-run steps. Follow your normal safety checks and do not use elevated privileges.
• Standardinstallationspfad: ~/.codex/skills/xmemo-memory.
• Alternativer Pfad: Konfigurieren Sie das direkte MCP-Profil in ~/.codex/config.toml mit bearer_token_env_var.

Anmeldedaten festlegen

Konfigurieren Sie Ihre Anmeldedaten vor dem Ausführen von Vorgängen. Setzen Sie XMEMO_KEY in der Umgebung, die zum Starten von Codex verwendet wird. bearer_token_env_var liest den Wert, ohne das Token in config.toml abzulegen. Wenn Sie interaktives Geräte-Login mit --allow-plaintext verwenden, beachten Sie, dass dieses Flag Anmeldedaten unverschlüsselt auf diesem Computer speichert:

export XMEMO_KEY='<your-xmemo-token>'
# Interactive alternative (stores credential unencrypted on this machine):
# node ~/.codex/skills/xmemo-memory/scripts/xmemo-skill.mjs login --allow-plaintext

XMEMO_AGENT_INSTANCE_ID generieren / bestätigen

Die Client-Konfiguration bildet die stabile Instanzidentität für diese Installation ab. Bestätigen Sie, dass env_http_headers XMEMO_AGENT_INSTANCE_ID abbildet, und verwenden Sie denselben nicht-geheimen Wert über Sitzungen hinweg wieder.

export XMEMO_AGENT_INSTANCE_ID='<stable-local-instance-id>'
# Persist and reuse this value for the same local install

Bestehenden Konfigurationsblock beibehalten

Verwenden Sie den geprüften Codex-Konfigurationsblock. Behalten Sie bearer_token_env_var und die XMemo-URL bei; fügen Sie Geheimnisse niemals direkt in config.toml ein:

[mcp_servers.xmemo]
url = "https://xmemo.dev/mcp"
bearer_token_env_var = "XMEMO_KEY"

Client neu starten

Starten Sie Codex nach dem Schreiben von Konfigurationsdateien, dem Ändern von Umgebungsvariablen oder der Installation des Skills neu, damit die neuen Komponenten erkannt werden.

Mit einem echten Recall-Aufruf testen

Führen Sie die erste Anfrage schreibgeschützt aus, um die Konnektivität vor dem Schreiben von Daten zu überprüfen. Diese Prüfung ändert den Speicherzustand nicht.

recall({ query: "connection check", limit: 1 })

Erwartete Antwort (wörtliche Form)

Ein erfolgreicher Aufruf gibt die unten stehende öffentliche bewertete Textform zurück; Referenz und Inhalt sind echte Werte aus dem autorisierten Speicherbereich.

### XMemo Memory Results:
1. Reference: <opaque-memory-id> | Location: <location>
   > <memory content>

Erste nützliche Aufgabe: Synthetischer Speicherlebenszyklus

Führen Sie die vollständige synthetische Speicheraufgabe über Speichern, Sitzungsübergang, Recall und Korrektur hinweg aus:

• 1. Synthetischen Fakt speichern: node scripts/xmemo-skill.mjs remember --content "Demo project timestamps use UTC." --path "projects/demo-onboarding/conventions" (oder MCP remember-Tool).
• 2. Zustandsloser Übergang: Öffnen Sie eine neue Codex-Terminal-Sitzung, um die Persistenz über Sitzungen hinweg zu überprüfen.
• 3. Recall mit Quellenzuordnung: node scripts/xmemo-skill.mjs recall --query "demo project timestamp format" (oder MCP recall-Tool). Überprüfen Sie Reference und Location in der zurückgegebenen Ausgabe.
• 4. Speicher korrigieren: node scripts/xmemo-skill.mjs update --id <active-memory-id> --content "Demo project timestamps use UTC with ISO 8601 formatting." (oder MCP update_memory-Tool).
• 5. Optionale Bereinigung: node scripts/xmemo-skill.mjs forget --id <active-memory-id> --confirm (oder MCP forget-Tool).

Funktionen und Profil-Tools

Codex hat Zugriff auf profilqualifizierte Tools, die im MCP-Dokumentationsvertrag für generic-public-Profil definiert sind:

• Kern-Speicher-Tools: remember, recall, update_memory, forget, read_memory, explain_memory, search_memory, recall_context.
• Arbeitsbereichs-Tools: get_mcp_identity, get_project_summary, project, todo, open_project_workspace, open_todo_board, ledger, open_ledger.

Einschränkungen und Grenzen

Betriebliche Grenzen und Einschränkungen für Codex:

• Arbeitsbereichsisolation: Operationen sind strikt auf den Arbeitsbereich des angemeldeten Benutzers beschränkt.
• Umgang mit Geheimnissen: Verwenden Sie immer bearer_token_env_var; kodieren Sie Tokens niemals fest in config.toml.
• Distributionsumfang: Nicht standardmäßige oder Drittanbieter-Forks von Codex bleiben als ungetestet markiert.

Häufige Fehler

Beheben Sie häufige Codex-Probleme mit diesen Wiederherstellungsschritten:

• 401 invalid_token — XMEMO_KEY fehlt, ist abgelaufen oder ungültig: Überprüfen Sie die Umgebung, die Codex startet, und starten Sie neu.
• 403 insufficient_scope — Dem Token fehlt die Berechtigung memory:read: Erzeugen Sie ein Token mit dem erforderlichen Bereich.
• Falsches Installationsziel — Überprüfen Sie, ob XMEMO_SKILL_DIR auf ~/.codex/skills/xmemo-memory gesetzt war.
• Skill-Neuladen erforderlich — Starten Sie Codex neu, um sicherzustellen, dass In-Memory-Skills neu geladen werden.

Aktualisierung und Entfernung

Wartungsverfahren für Codex:

• Aktualisierung: Führen Sie den Installationsbefehl erneut aus, um das neueste Skill-Release abzurufen, oder aktualisieren Sie die MCP-Endpunkt-URL.
• Entfernung: Löschen Sie das Verzeichnis ~/.codex/skills/xmemo-memory oder entfernen Sie [mcp_servers.xmemo] aus ~/.codex/config.toml.