AgentBridge Local

English | 简体中文

Ehemals MiMo Bridge MCP.

AgentBridge Local ist eine lokale MCP-Orchestrierungskonsole, mit der Codex MiMo Code, Reasonix TUI und zukünftige lokale Coding-Agenten koordinieren kann, ohne die Kontrolle über die Überprüfung aufzugeben.

Codex ist gut in Planung, Architektur und Überprüfung. Lokale Coding-Agenten sind nützlich für lange Implementierungsschleifen. AgentBridge Local trennt diese Aufgaben:

• Codex plant und überprüft.

• MiMo / Reasonix führen abgegrenzte Aufgaben aus.

• Jede Aufgabe läuft in einem Git Worktree.

• Codex liest ein kompaktes Review-Paket, bevor es Diffs, Logs oder Dateien berührt.

• Sie entscheiden, was gemerged wird.

Das Ziel ist nicht, „einen Agenten frei in Ihrem Repo editieren zu lassen". Das Ziel ist kontrollierte Delegation: kleiner Aufgabenumfang, isolierte Ausführung, tokenarme Überprüfung und eine menschliche oder von Codex gesteuerte endgültige Entscheidung.

Warum es existiert

Lange Codierungsschleifen können viele Token verbrauchen und das wichtige Überprüfungssignal vergraben. AgentBridge Local bietet ein sichereres Muster:

1. Codex zerlegt die Arbeit in eine abgegrenzte Aufgabe.

2. Ein lokaler Agent implementiert sie in einem isolierten Worktree.

3. Der Daemon erstellt ein kleines Review-Paket: geänderte Dateien, Diff-Statistik, Risikoflags, Bereichsbericht, Testergebnis und Log-Ende.

4. Codex überprüft zuerst das Paket.

5. Nur riskante oder unklare Aufgaben werden zu fokussierten Diff-, fokussierten Datei- oder begrenzten Log-Lesevorgängen eskaliert.

6. Codex oder der Benutzer akzeptiert, lehnt ab, merged, verwirft oder bittet den Agenten fortzufahren.

Das bedeutet, dass Codex auf dem teuren, hochwirksamen Platz bleiben kann: Planung, Grenzkontrolle, Überprüfung und endgültige Annahme.

Related MCP server: codex-as-mcp

Was Sie bekommen

• Lokaler MCP-Daemon unter http://127.0.0.1:3210/mcp.

• Browser-Admin-UI unter http://127.0.0.1:3210/.

• MiMo Code-Ausführung über Legacy-mimo_*-Tools und die gemeinsame Aufgabenwarteschlange.

• Reasonix TUI-Ausführung über generische agent_*-Tools.

• Agentenbewusste Aufgabenwarteschlange, die MiMo und Reasonix parallel ausführen kann, wenn ihre bearbeitbaren Pfade sich nicht überschneiden.

• Dauerhafte P0-Aufgabenannahme mit persistentem Platzhalter, Anforderungskorrelation, idempotenten Wiederholungen und einer Obergrenze von acht gleichzeitigen Aufgaben.

• Git-Worktree-Isolation für Aufgabenänderungen.

• Dynamischer Aufgabenumfang mit bearbeitbaren/schreibgeschützten Grenzen pro Aufgabe.

• Tokenarmes Review-Paket-Protokoll für Codex-Überprüfung.

• Wiederherstellungs-Posteingang, damit Codex abgeschlossene oder fehlgeschlagene Aufgaben nach einer Unterbrechung wiederherstellen kann.

• Modell-Routing-Profile für einfache, normale, komplexe, risikoreiche und multimodale Aufgaben.

• Multimodale Aufgabenanhänge mit eingefügten Bildern und hochgeladenen Dateien.

• Sichere lokale Öffnungsaktionen für Aufgabenordner, Sitzungsordner, MiMo-CMD-Sitzungen, Reasonix-TUI-CMD-Sitzungen und Reasonix-GUI-Begleitansicht.

• Windows-portables ZIP- und EXE-Installationsprogramm mit gebündelter Node-Laufzeit.

Wie es funktioniert

flowchart TD
  A["Codex / Main Agent"] -->|"MCP"| B["AgentBridge Local Daemon"]
  B --> C["Agent Registry"]
  C --> D["MiMo Code Runner"]
  C --> E["Reasonix TUI Runner"]
  C --> F["Future Local Agents"]
  D --> G["Task Git Worktree"]
  E --> G
  F --> G
  G --> H["Review Package"]
  H --> I{"Risk or unclear result?"}
  I -->|"No"| J["Accept / Merge / Discard"]
  I -->|"Yes"| K["Focused diff / file / log"]
  K --> J
  J --> A

Aktueller Status

AgentBridge Local ist ein frühes Alpha-Projekt.

• Ziel-BS: Windows 10/11 x64.

• Laufzeit: Nur-Localhost-Node-Daemon.

• MCP-Endpunkt: http://127.0.0.1:3210/mcp.

• Admin-UI: http://127.0.0.1:3210/.

• Verteilung: portables ZIP- und EXE-Installationsprogramm mit gebündeltem Node.

• MiMo Code und Reasonix sind nicht gebündelt; installieren und melden Sie sich separat bei diesen Tools an.

• Saubere Windows-Validierung und Community-Tests sind weiterhin willkommen.

Schnellstart

Option A: Windows-Installationsprogramm verwenden

1. Laden Sie das neueste Release-Asset herunter:

   • MiMoBridgeSetup-win10-win11-x64.exe

2. Führen Sie das Installationsprogramm aus.

3. Starten Sie AgentBridge Local über den installierten Starter.

4. Öffnen Sie die Admin-UI:

   http://127.0.0.1:3210/

5. Richten Sie die Codex-MCP-Konfiguration auf:

   http://127.0.0.1:3210/mcp

Option B: Aus Quellcode ausführen

Voraussetzungen:

• Windows 10/11 x64.

• Git.

• Node.js 18+.

• Codex oder ein anderer MCP-fähiger Hauptagent.

• MiMo Code installiert und angemeldet, wenn Sie MiMo-Ausführung wünschen.

• Reasonix installiert und konfiguriert, wenn Sie Reasonix-TUI-Ausführung wünschen.

Vom Repository-Root aus:

npm.cmd install
npm.cmd run build
powershell -ExecutionPolicy Bypass -File apps/local-daemon/launcher.ps1 start -Open

Starter-Steuerung:

powershell -ExecutionPolicy Bypass -File apps/local-daemon/launcher.ps1 status
powershell -ExecutionPolicy Bypass -File apps/local-daemon/launcher.ps1 start -Open
powershell -ExecutionPolicy Bypass -File apps/local-daemon/launcher.ps1 stop
powershell -ExecutionPolicy Bypass -File apps/local-daemon/launcher.ps1 restart -Open
powershell -ExecutionPolicy Bypass -File apps/local-daemon/launcher.ps1 adopt
powershell -ExecutionPolicy Bypass -File apps/local-daemon/launcher.ps1 allow-root -Path "C:\path\to\project" -Restart
powershell -ExecutionPolicy Bypass -File apps/local-daemon/launcher.ps1 logs

allowedRoots ist eine maschinenweite Grenze und wird niemals durch eine Aufgabe erweitert. Der Befehl allow-root löst und validiert das Verzeichnis, dedupliziert es case-insensitiv, schreibt die aktive Konfiguration und führt optional einen sicheren Neustart durch. adopt gelingt nur, wenn der Localhost-Portbesitzer, die Node-Ausführbare, der Daemon-Eintrag und die Health-Identität exakt übereinstimmen.

MCP-Endpunkt

Konfigurieren Sie Codex für die Verwendung von:

http://127.0.0.1:3210/mcp

Bitten Sie dann Codex, mit einer abgegrenzten Aufgabe zu beginnen, z.B.:

Use AgentBridge Local. Ask MiMo or Reasonix to update only docs/example.md.
Review the result through the Review Package first, then merge only if the scope and tests are clean.

mimo_start_task und agent_start_task persistieren und geben einen Platzhalter vor der Worktree-Erstellung zurück. Eine erfolgreiche neue Anfrage gibt task_id, request_id, status="preparing_worktree", queue_state und idempotent_replay zurück. Clients sollten idempotency_key senden und nach einem Timeout wiederverwenden; der gleiche Schlüssel mit anderen Parametern wird abgelehnt.

Der Aufgabenstart durchläuft preparing_worktree -> starting_agent -> running. Ein Phasenfehler speichert eine strukturierte error_detail mit seiner request_id, während der Legacy-String error aus Kompatibilitätsgründen verfügbar bleibt.

Der release-sichere Client verwendet nur integrierte Node-Module und REST, sodass er keine node_modules dieses Quellbaums oder das MCP-SDK benötigt:

node scripts/mimo-bridge-client.mjs health
node scripts/mimo-bridge-client.mjs start --json .\task.json --idempotency-key my-stable-key
node scripts/mimo-bridge-client.mjs wait --task-id task_xxx --timeout-seconds 1800

Portable und installierte Distributionen bieten denselben Einstieg wie MiMo Bridge Client.cmd und führen ihn mit der gebündelten Node-Laufzeit aus.

Die passende Codex-Nutzungsfähigkeit ist unter skills/use-mimo-bridge-mcp versioniert und in beiden Distributionen enthalten. Die Installation ist explizit, sodass eine vorhandene angepasste Fähigkeit niemals stillschweigend überschrieben wird:

& "$env:LOCALAPPDATA\MiMoBridgeApp\Install MiMo Bridge Codex Skill.cmd"

Der Befehl sichert eine vorhandene use-mimo-bridge-mcp-Fähigkeit vor dem Ersetzen. Öffnen Sie danach eine neue Codex-Sitzung, wenn die Fähigkeitsliste bereits zwischengespeichert war.

Erster Aufgabenablauf

1. Öffnen Sie die Admin-UI.

2. Wählen Sie den Arbeitsbereich und den Aufgabenumfang.

3. Wählen Sie Auto-Routing oder wählen Sie manuell MiMo / Reasonix.

4. Fügen Sie das Aufgabenobjektiv ein. Sie können Screenshots einfügen oder Dateien für multimodale Aufgaben hochladen.

5. Lassen Sie den Agenten in einem Worktree laufen.

6. Überprüfen Sie das kompakte Ergebnis.

7. Akzeptieren, mergen, verwerfen oder bitten Sie den Agenten fortzufahren.

Tokenarme Überprüfungs-Workflow

AgentBridge Local ist auf begrenzte Überprüfung ausgelegt, nicht auf vollständige Kontext-Dumps.

flowchart TD
  A["Start bounded task"] --> B["Wait once"]
  B --> C["Read Review Package"]
  C --> D["Check scope, changed files, tests, risk flags"]
  D --> E{"Need more evidence?"}
  E -->|"No"| F["Decide accept / merge / discard"]
  E -->|"Yes"| G["Read focused diff / file / log tail"]
  G --> F

Unterstützte Agenten

Sicherheitsmodell

AgentBridge Local hält bewusst eine enge Sicherheitsgrenze ein:

• Der Daemon bindet nur an Localhost.

• Aufgaben laufen in Git Worktrees.

• Maschinenweite allowedRoots begrenzen, welche Ordner berührt werden können.

• Health- und Arbeitsbereichsgrenzen-Fehler geben nur die aktiven Konfigurationsmetadaten, einen geschwärzten Fingerabdruck, Zählungen und den angeforderten normalisierten Pfad preis; sie listen niemals andere erlaubte Roots auf.

• Jede Aufgabe zeichnet ihren eigenen bearbeitbaren/schreibgeschützten Bereichs-Snapshot auf.

• Änderungen außerhalb des Bereichs erscheinen in den Risikoflags des Review-Pakets.

• Browser-Öffnungsaktionen sind feste Aktionen, keine willkürliche Befehlsausführung.

• Vollständige Logs, vollständige Diffs, vollständige Dateien und rohe lokale Pfade sind keine Standard-Review-Ausgabe.

• MiMo und Reasonix sollten ihre eigenen Aufgaben-Worktrees nicht mergen.

Setzen Sie den Daemon nicht einem öffentlichen Netzwerk aus.

Build, Test und Paketierung

Build:

npm.cmd run build
npm.cmd --prefix apps/admin-ui run build
npm.cmd --prefix apps/local-daemon run build

Führen Sie normale Regression aus, mit Ausnahme des bekannten hängenden Runner-Integrationstests:

$tests = Get-ChildItem -LiteralPath 'tests' -Filter '*.test.mjs' |
  Where-Object { $_.Name -ne 'runner-integration.test.mjs' } |
  ForEach-Object { $_.FullName }
node --test $tests

Paket:

npm.cmd run package:portable
npm.cmd run package:installer
npm.cmd run validate:release

Generierte Release-Ausgaben:

• artifacts/MiMoBridge-portable-win10-win11-x64.zip

• artifacts/MiMoBridgeSetup-win10-win11-x64.exe

• artifacts/release-validation.json

Die Artefaktnamen verwenden aus Kompatibilitätsgründen weiterhin die ursprüngliche MiMoBridge-Benennung. Der Produktname ist jetzt AgentBridge Local.

Dokumentation

• 中文 README

• Fehlerbehebung

• Gute erste Aufgaben

• GitHub-Veröffentlichungs-Checkliste

• Versionshinweise v0.1.0-alpha

• Demo-Skript

Dokumente für Maintainer-Übergabe:

1. PROJECT_MEMORY.md - Langzeitprojektspeicher und aktueller Release-Status.

2. AGENTS.md - Agentenregeln, Zusammenarbeitsworkflow und Befehle.

3. docs/HANDOVER_STATUS.md - kurze aktuelle Übergabezusammenfassung.

4. docs/OPEN_TASKS.md - anstehende Arbeiten und Risiken.

5. docs/RELEASE_VALIDATION.md - Checkliste für saubere Windows-Validierung.

6. docs/modules/multi-agent-dispatch.md - Notizen zum Multi-Agenten-Design von MiMo / Reasonix.

Mitwirken

Dieses Projekt benötigt besonders:

• Saubere Windows 10/11-Installations- und portable ZIP-Validierung.

• Codex-MCP-Setup-Beispiele.

• Testen des Aufgabenflusses von MiMo und Reasonix.

• Admin-UI-Screenshots und Demo-GIFs.

• Sicherere Berichte zur Fehlerwiederherstellung.

• Dokumentationskorrekturen für neue Benutzer.

• Neue lokale Agentenadapter.

Beginnen Sie mit CONTRIBUTING.md, docs/GOOD_FIRST_ISSUES.md und SECURITY.md.

Bitte fügen Sie keine API-Schlüssel, Token, MiMo-Anmeldedaten, Reasonix-Anmeldedaten, vollständige private Logs, lokale Worktrees oder ungeschwärzte persönliche Pfade in Issues oder Pull Requests ein.

Lizenz

MIT. Siehe LICENSE.