Agent Bridge

Codex überwacht Claude Code und DeepSeek Harness. Bridge ruft selbst kein LLM auf.

Lass Codex der einzige Supervisor sein. Claude Code oder DeepSeek Harness führt die Umsetzung durch. Du prüfst, verifizierst und wendest in Codex an.

Ein Befehl

npx -y codex-agent-bridge

Dann starte eine neue Codex-Runde. Du siehst die bridge_*-Tools.

Dieser Befehl: Installiert die Laufzeit in ~/.agent-bridge, schreibt Codex Skill und MCP (mit lokalem node.exe, nicht npx.cmd) und führt einmal doctor aus.

Zum Aktualisieren denselben Befehl erneut ausführen. Deinstallation:

npx -y codex-agent-bridge uninstall
npx -y codex-agent-bridge uninstall --purge

--purge löscht ~/.agent-bridge.

Voraussetzungen

Was wir nicht übernehmen

• Wir installieren kein Claude Code / DeepSeek Harness

• Wir ändern deren model / provider / reasoning effort nicht

• Wir rufen kein LLM auf

Welcher Worker vorhanden ist, kann eingesetzt werden. Wenn keiner vorhanden ist, zeigt doctor dies an.

Related MCP server: cc-agent

Was es tut

Codex  ──bridge_run──►  Claude Code / DeepSeek Harness
  ▲                         │
  │      ReviewPacket       │  在独立 worktree 里改代码
  │      verification       │  不得 commit / push / merge
  └──── bridge_apply ◄──────┘

Geschlossener Kreislauf:

bridge_run
→ WAITING_FOR_INPUT 时 bridge_respond
→ AWAITING_REVIEW + ReviewPacket
→ bridge_approve     任务分支 checkpoint，不是完成发布
→ bridge_apply       cherry-pick 到当前分支，不是 merge

Turn-Ende ≠ Aufgabenabschluss. Diff erkennt nur baseCommit vs. worktree.

bridge_run wählt nur den Worker aus: claude oder deepseek (zum Debuggen replay / fake). Kein model / provider / effort übergeben.

Wenn DeepSeek Harness nicht im Standardpfad liegt, setze AGENT_BRIDGE_DEEPSEEK_ROOT.

Nutzungshinweise

• Ziel muss ein eigenständiges Git-Repository sein. Jeder bridge_*-Aufruf verwendet dasselbe project. Das Aufgaben-UUID-Feld heißt task.

• Es kann nur einen Writer pro Projekt gleichzeitig geben. Ein zweiter Schreiber gibt CORE_LOCK_HELD zurück.

• Nach Änderungen am MCP muss Codex neu gestartet werden; alte Sitzungen sehen die neuen Tools nicht.

• Eine beschädigte tasks.json führt zu TASK_STORE_CORRUPTED und wird nicht als leerer Store behandelt.

Neue Version veröffentlichen

Lokales npm publish verlangt jedes Mal 2FA – das ist npm-Vorschrift und kann nicht wie git push passwortfrei gemacht werden.

Richtige Vorgehensweise: Version ändern → Tag setzen → pushen, GitHub Actions veröffentlicht mit Trusted Publishing auf npm, keine Passworteingabe mehr.

Einmalige Konfiguration (nur einmal nötig): codex-agent-bridge npm-Einstellungen öffnen → Trusted Publisher → GitHub Actions, eintragen:

Danach jedes Mal:

# 先改 package.json 里的 version，提交
git tag v1.2.0
git push origin main --tags

Entwicklung aus dem Quellcode

npm install
npx tsx src/cli.ts setup --dev
npm test

--dev lässt MCP auf das aktuelle Repository verweisen, nicht auf ~/.agent-bridge.

Dokumentation

Das Repository-Verzeichnis heißt möglicherweise noch Agent Relay. Der Produktname ist Agent Bridge. Der npm-Paketname ist codex-agent-bridge.