# Wiederaufnahme & Agentenübergabe Erfassen Sie explizite Sitzungs-Checkpoints, stellen Sie Projektkontext wieder her, verfolgen Sie Entscheidungen sowie Blocker mit Quellenangaben und übergeben Sie Arbeiten zwischen Agenten ohne unkontrollierte Umfangsausweitung. - Canonical: https://docs.xmemo.dev/de/docs/guides/resume-and-handoff - Locale: de-DE - Content-Locale: de-DE - Canonical-Content-Digest: f7f1e02f35c3c797c1b7fcc4aee1048fa1f409ef7ed79ecaf362c4d2d5f7b15a - Edition-Digest: f345634cbd4f704629f7130fea0c3a9dd630068f407ad019c573081983b05af2 - Source-Revision: sha256:dacab21c9fc471e388ff6bbe4a84e7266ffca6eed88baebabcf7f68ee9957d6a ## Ziel des Benutzers und Workflow-Grenzen Dieser praktische Workflow ermöglicht es Entwicklern und KI-Agenten, unterbrochene Sitzungen wiederaufzunehmen, aktiven Kontext über CLI-/IDE-Neustarts hinweg wiederherzustellen und laufende Arbeiten zwischen verschiedenen Agenten (wie Claude Code, Codex, Cursor oder Hermes) zu übergeben, ohne Architekturentscheidungen, aktive Blocker oder Aufgabenkontinuität zu verlieren. Der Workflow garantiert, dass Kontextübergaben einen abgegrenzten, strukturierten Zustand übermitteln, anstatt uneingeschränkte Konversationsverläufe auszugeben oder Anmeldeinformationen preiszugeben. ## Verfügbarkeit und Voraussetzungen Die für Wiederaufnahme und Übergabe erforderlichen Funktionen stehen über den eigenständigen XMemo Skill und native MCP-Client-Profile mit expliziten Berechtigungsgrenzen zur Verfügung: - Eigenständiger Skill (Claude Code, Codex, OpenClaw): Wortgetreue CLI-Befehle aus der bereitgestellten 1.1.35 help.mjs: save-state und restore-state (Zeilen 88-95), restart-snapshot und restart-restore (Zeilen 104-111), recall-context (Zeilen 84-87), remember (Zeilen 72-75) und todo-add/list/done (Zeilen 112-123). - MCP-Profil claude-plugin: Umfasst update_state, create_restart_snapshot, restore_restart_snapshot, record_event, recall_context, remember, recall, todo, create_pending_decision und resolve_decision. - MCP-Profile cursor-plugin und ordinary-full: Umfassen update_state, create_restart_snapshot, restore_restart_snapshot, record_event, recall_context, remember, recall, update_project_decision, update_project_todo, list_memory_todos, complete_memory_todo und query_audit. - MCP-Profile generic-public, chatgpt-public und public-only: Stellen schreibgeschützte Zusammenfassungsprojektionen wie get_project_summary(project_id, focus) und memory_overview bereit; Schreibwerkzeuge erfordern eine authentifizierte Plugin-Sitzung. - Voraussetzungen: Aktives Authentifizierungstoken (XMEMO_KEY oder lokale skill-credentials.json) mit memory:write-Bereich für Checkpoint-Persistenz und memory:read für kontextuellen Abruf. ## Eine vollständige Aufgabe: Synthetische Multi-Agenten-Übergabe In diesem synthetischen Szenario arbeitet Agent Alpha (in Claude Code CLI ausgeführt) an einem Datenbank-Verbindungspooling-Refactoring im Projekt proj_payments_v2, zeichnet eine explizite Entscheidung und einen Blocker auf, versiegelt eine Neustart-Momentaufnahme (Restart Snapshot) und übergibt die Ausführung an Agent Beta (in Cursor IDE ausgeführt). ## Aktiven Zustand und Blocker erfassen Agent Alpha zeichnet vor der Übergabe seine aktuelle Aufgabe und den aktiven Blocker mithilfe von save-state oder update_state auf: ```bash node scripts/xmemo-skill.mjs save-state --key active_task --content "Refactoring database connection pooling to asyncpg: blocked on internal CA bundle" --ttl_seconds 86400 ``` ## Neustart-Momentaufnahme für Kontinuität erstellen Agent Alpha erfasst das vollständige Sitzungskontinuitätspaket vor der Übergabe mithilfe von restart-snapshot oder create_restart_snapshot: ```bash node scripts/xmemo-skill.mjs restart-snapshot --state_key active_task --session_id sess_alpha_0928 --ttl_seconds 604800 ``` ## In empfangender Agentensitzung wiederaufnehmen und wiederherstellen Agent Beta startet in Cursor IDE, stellt die Momentaufnahme wieder her und ruft abgegrenzten Hintergrundkontext ab: ```bash node scripts/xmemo-skill.mjs restart-restore --source_session_id sess_alpha_0928 --target_session_id sess_beta_0929 node scripts/xmemo-skill.mjs recall-context --query "internal CA bundle TLS root pin database pooling" --max_items 5 --max_tokens 2000 ``` ## Beobachtbares Ergebnis Eine erfolgreiche Übergabe erzeugt eine explizite, überprüfbare Bestätigung in der Werkzeugantwort ohne ausschmückende Konversationsfloskeln: - Ausgabe der Momentaufnahme-Erstellung: create_restart_snapshot gibt zurück: "✅ Restart snapshot created. ID: snap_xxx Captured: state=1, events=1, reminders=0, decisions=1". - Wiederherstellungsbeleg: restore_restart_snapshot stellt den aktiven Zustandsplatz wieder her, protokolliert ein Audit-Wiederherstellungsereignis unter target_session_id und liefert den exakten wiederhergestellten Zustandsinhalt sowie den Blocker-Grund zurück. - Kontextuelle Verankerung: recall_context liefert strukturierte Speicher-Elemente zurück, die mit Quell-session_id, agent_id und exakten Erstellungszeitstempeln versehen sind, sodass Agent Beta die Entscheidungsquelle sofort überprüfen kann. ## Worauf Agenten zugreifen können Der Kontextzugriff über Sitzungen hinweg ist durch autorisierte Bereiche und Herkunft streng begrenzt: - Abgegrenzter Speicherkontext: Wiederherstellende Agenten erhalten strukturierte Zustandsplätze, Zeitachsen-Meilensteine und explizit abgerufene Erinnerungen, die der Abfrage entsprechen; sie erhalten keine irrelevanten Entwickler-Erinnerungen oder unzusammenhängenden Projekte. - Read-Your-Writes-Konsistenz: Zustandsaktualisierungen und Neustart-Momentaufnahmen werden sofort in den transaktionalen Metadatenspeicher geschrieben, wodurch Race Conditions durch verzögerte Konsistenz (Eventual Consistency) zwischen übergebenden Agenten verhindert werden. - Herkunft des Aufrufers: Der abgerufene Kontext enthält die Identität des Aufrufers (source_identity, agent_id und node_id), sodass nachfolgende Agenten Anweisungen menschlicher Benutzer von automatisierten Vorschlägen gleichrangiger Agenten unterscheiden können. ## Freigabe- und Speichergrenzen Strenge Datenschutz- und Sicherheitsisolationsregeln gelten für alle Wiederaufnahme- und Übergabeoperationen: - Keine rohen Transkript-Dumps: Speichern Sie niemals vollständige Chat-Transkripte oder Denkspuren von Modellen im Zustand oder Speicher. Die Übergabe übermittelt ausschließlich strukturierte Zustandszusammenfassungen, explizite Entscheidungsereignisse und verifizierte Fakten. - Keinerlei Offenlegung von Anmeldedaten: Token, API-Schlüssel, Passwörter und Autorisierungs-Header dürfen niemals in state_key, content oder metadata_json geschrieben werden. - Projektisolationsgrenze: An project:proj_payments_v2 gebundene Momentaufnahmen sind für Sitzungen, die unter einem anderen Projekt oder persönlichen Bereich ohne explizite Teamberechtigungen authentifiziert sind, streng unzugänglich. ## Fehlerbehebung Behandeln Sie häufige Wiederaufnahme- und Übergabefehler mit deterministischen Fallback-Strategien: - Abgelaufene Momentaufnahme oder TTL: Wenn eine Momentaufnahme ttl_seconds überschreitet (standardmäßig 7 Tage für Momentaufnahmen, 24 Stunden für aktiven Zustand), meldet restore_restart_snapshot, dass die Momentaufnahme abgelaufen ist. Weichen Sie auf get_project_context(project_id="proj_payments_v2") oder recall_context mit einer projektbezogenen Abfrage aus. - Fehlende Sitzungs-ID: Wenn source_session_id nicht verfügbar oder verloren ist, stellen Sie den neuesten Zustandsdatensatz mit node scripts/xmemo-skill.mjs restore-state --key active_task wieder her oder listen Sie aktive TODOs über todo-list auf. - Bereichs- oder Mandanten-Diskrepanz: Wenn ein Agent versucht, eine Momentaufnahme über einen unbefugten Mandanten oder einen nicht übereinstimmenden Projektbereich wiederherzustellen, weist der Server die Anfrage mit HTTP 403 Forbidden ab. Überprüfen Sie die gebundene Projekt-ID in Ihrer Client-Konfiguration. ## Verwandte Referenzen Weitere Informationen zu Architektur, Bereichsdefinitionen und Werkzeugkatalogen finden Sie in den folgenden Leitfäden: - Agentenübergreifender Workflow: /docs/operations/cross-agent-workflow für Orchestrierungskonzepte. - Bereiche und Isolation: /docs/concepts/scopes für die 4-stufige orthogonale Bereichshierarchie. - Projektarbeitsbereiche: /docs/concepts/projects für Projektverknüpfungen und die Durchsetzung von Grenzen. - Schnellstart: /docs/quickstart für Client-Konfiguration und Erstauthentifizierung. - MCP-Werkzeugreferenz: /docs/tools/recall-context und /docs/tools/remember für Low-Level-Werkzeugparameter. ## ChatGPT-Benutzer Geben Sie ChatGPT dauerhaften Zugriff auf Ihre XMemo-Präferenzen, Projektfakten, Entscheidungen und TODOs, ohne Bearer-Token in einen Chat einzufügen. Verbinden Sie den gehosteten XMemo-MCP-Server über den OAuth-Ablauf der ChatGPT-/OpenAI-App und genehmigen Sie anschließend die Berechtigungen memory:read und memory:write für Ihr XMemo-Konto. Speichern Sie eine synthetische Präferenz oder Projektnotiz, starten Sie einen neuen Chat und fordern Sie ChatGPT auf, diese vor der Fortsetzung der Arbeit über XMemo abzurufen. Wenn OAuth fehlschlägt oder Tools nicht angezeigt werden, melden Sie sich in der Host-App vom MCP-Server ab, verbinden Sie die XMemo-Server-URL erneut und versuchen Sie es noch einmal, bevor Sie direkte Token erstellen. ## Copilot- / Codex-Entwickler Übertragen Sie Repository-Entscheidungen, Programmierkonventionen, Bugfix-Notizen und den Aufgabenverlauf zwischen IDE- und CLI-Agenten. Verwenden Sie OAuth für VS Code / GitHub Copilot und Gemini CLI, sofern verfügbar. Behalten Sie für Copilot CLI, Codex, Cursor oder andere direkte MCP-Clients XMEMO_KEY in der lokalen Umgebung oder im Secret-Store und setzen Sie eine stabile XMEMO_AGENT_INSTANCE_ID. Erfassen Sie eine Codebasis-Entscheidung oder einen Bugfix und fordern Sie den nächsten IDE- oder CLI-Agenten auf, den relevanten XMemo-Kontext vor dem Bearbeiten abzurufen. Wenn Abrufe leer bleiben, überprüfen Sie den ausgewählten MCP-Konfigurationspfad, die Umgebungsvariable XMEMO_KEY für direkte Clients und veraltete OAuth-Anmeldedaten in der Host-App. ## Verantwortlicher für Team- / Enterprise-Pilotprojekte Evaluieren Sie geteilten Speicher mit Kontokontrollen, Quellenzuordnung, Export-/Lösch-Workflows und prüfersicheren Einrichtungsnachweisen. Erstellen oder betreten Sie den geschützten XMemo-Arbeitsbereich, laden Sie freigegebene Benutzer ein und verbinden Sie jeden Client über OAuth oder bereichsbezogene direkte Anmeldedaten gemäß den Bereitschafts-Badges. Lassen Sie ein Mitglied des Pilotprojekts eine synthetische Team-Erinnerung speichern, bestätigen Sie die Quellenzuordnung in XMemo und prüfen Sie anschließend Lösch-/Export- sowie Support-Pfade. Wenn ein Mitglied keine Verbindung herstellen kann, prüfen Sie Rollenberechtigungen, OAuth-Genehmigung, Client-Bereitschaftsstatus und Support-Hinweise, bevor Sie ein neues Token ausstellen. ## Betreiber autonomer Agenten Ermöglichen Sie es Headless- oder zeitgesteuerten Agenten, Fortschritte aufzuzeichnen, frühere Entscheidungen abzurufen und eine stabile, nicht-geheime Instanzidentität beizubehalten. Rufen Sie /api/v1/mcp/config/autonomous-agent ab. Bevorzugen Sie auth_modes.oauth, wenn der Runner OAuth + benutzerdefinierte Header unterstützt; verwenden Sie auth_modes.xmemo_key mit XMEMO_KEY aus einem Secret-Store nur für vollständig autonome Headless-Runner. Führen Sie eine synthetische Aufgabe aus, die den Fortschritt in XMemo schreibt, starten Sie den Runner neu und bestätigen Sie, dass er diesen Fortschritt unter Verwendung derselben XMEMO_AGENT_INSTANCE_ID abruft. Wenn sich die Zuordnung ändert oder Abrufe über Instanzen hinweg aufgeteilt werden, speichern Sie XMEMO_AGENT_INSTANCE_ID außerhalb von Git und stellen Sie sicher, dass der Runner diese nicht bei jedem Start neu generiert.