OpenHandoff

Tragbare, lokal-first Kontextübergaben zwischen KI-Codierungsagenten.

OpenHandoff bewahrt die beständige Projektwahrheit in zwei kleinen Dateien:

• CONTEXT.md für Menschen und Obsidian;

• context.json für Agenten, MCP-Adapter und Automatisierung.

Das erste MVP ist bewusst langweilig und überprüfbar: kein Cloud-Konto, keine versteckte Datenbank, und die Schwärzung erfolgt, bevor die Übergabe geschrieben wird. Zukünftige Adapter können Codex-, Claude-Code-, Cursor- und Windsurf-Transkripte lesen, ohne ein herstellerspezifisches Speicherformat zu erzwingen.

OpenHandoff ist für öffentliche Repositorys und Teamübergaben konzipiert: Dateien sind Klartext, der MCP-Server ist abhängigkeitsfrei, und geheimnisartige Werte werden vor der Persistenz geschwärzt.

Skill-Paket

Das Repository enthält drei portable Skills unter skills/:

• openhandoff-context — Kontext zwischen Agenten erfassen, wiederherstellen und packen.

• openhandoff-privacy — Übergaben und Transkripte prüfen, bevor sie geteilt werden.

• openhandoff-release — getestete, dokumentierte, reproduzierbare Releases vorbereiten.

Kopieren Sie ein Skill-Verzeichnis in Ihr Codex-Skills-Verzeichnis oder installieren Sie es mit dem Codex-Skill-Installer über dieses GitHub-Repository. Die Skills sind bewusst schmal gehalten, damit sie unabhängig verwendet werden können.

Related MCP server: ai-cortex

Schnellstart

python -m venv .venv
source .venv/bin/activate
pip install -e .
openhandoff init .context --title "My project"
openhandoff capture .context \
  --title "My project" \
  --decision "Use SQLite" \
  --todo "Add the MCP adapter" \
  --notes "The next agent should run the test suite first."
openhandoff show .context

Für eine normale Benutzerinstallation verwenden Sie pipx install openhandoff, nachdem ein Release veröffentlicht wurde. Entwicklungsabhängigkeiten und Prüfungen sind in CONTRIBUTING.md dokumentiert.

Erstellen Sie einen kompakten Kontextausschnitt für eine bestimmte Aufgabe. Übereinstimmende Entscheidungen, TODOs und Notizzeilen werden zuerst behalten, dann wird das Ergebnis deterministisch auf das angeforderte Budget gekürzt:

openhandoff pack .context --task "MCP adapter" --max-chars 4000

MCP-Server

Der abhängigkeitsfreie MCP-Server stellt load_handoff, save_checkpoint, search_handoff und pack_context über stdio bereit:

openhandoff-mcp

Für eine lokale Agentenkonfiguration verwenden Sie den Befehl openhandoff-mcp ohne Netzwerkzugriff. Der Server liest und schreibt nur den vom Agenten bereitgestellten Übergabepfad.

Beispielkonfiguration für Codex:

[mcp_servers.openhandoff]
command = "openhandoff-mcp"
args = []

Beispielkonfiguration für Claude Desktop:

{
  "mcpServers": {
    "openhandoff": {
      "command": "openhandoff-mcp",
      "args": []
    }
  }
}

Agentenereignisse erfassen

openhandoff-hook akzeptiert ein JSON-Ereignis (oder Klartext) auf stdin, schwärzt zugangsdatenartige Werte und hängt das Ergebnis an .context/events.jsonl an:

printf '%s\n' '{"type":"agent_message","message":"finished"}' \
  | openhandoff-hook --path .context

Codex kann seine notify-Nutzlast direkt an den Hook senden. Fügen Sie dies zu Ihrer Codex-Konfiguration hinzu (der Befehl empfängt die JSON-Nutzlast auf stdin):

notify = ["openhandoff-hook", "--path", ".context"]

Für Claude Code binden Sie dieselbe ausführbare Datei in den Befehlshook in Ihren Einstellungen ein. Die genaue Einstellungsdatei kann je nach Claude-Code-Version variieren; dies ist ein illustratives Beispiel:

{
  "hooks": {
    "afterTurn": [
      {"command": "openhandoff-hook --path .context"}
    ]
  }
}

Transkript importieren

Codex- und Claude-Code-JSONL-Ereignisströme können in dasselbe Format importiert werden:

openhandoff import-transcript ./rollout.jsonl .context --title "Project handoff"

Roadmap

1. Cursor- und Windsurf-Transkriptadapter.

2. Datei- und Commit-Zitate in aufgabenspezifischen Kontextpaketen.

3. Obsidian- und GitHub-Synchronisierung mit Geheimnisprüfung und Review-Gates.

Projektstatus

• Lizenz: MIT; siehe LICENSE.

• Sicherheitsmeldungen: siehe SECURITY.md.

• Beiträge: siehe CONTRIBUTING.md.

• Versionshinweise: siehe CHANGELOG.md.

• Architektur: siehe docs/architecture.md.

• Release-Prozess: siehe docs/releasing.md.

Das Projekt befindet sich in einem frühen Stadium und freut sich über Feedback aus der Praxis, Integrationen und Verbesserungen der Dokumentation. Bitte committen Sie keine Chat-Transkripte, Anmeldedaten oder private Obsidian-Daten.