AgentBridge Local

Inglés | 简体中文

Anteriormente MiMo Bridge MCP.

AgentBridge Local es una consola de orquestación MCP local-first que permite a Codex coordinar MiMo Code, Reasonix TUI y futuros agentes de codificación locales sin renunciar al control de revisión.

Codex es bueno en planificación, arquitectura y revisión. Los agentes de codificación locales son útiles para bucles de implementación largos. AgentBridge Local separa esas tareas:

• Codex planifica y revisa.

• MiMo / Reasonix ejecutan tareas acotadas.

• Cada tarea se ejecuta dentro de un Git Worktree.

• Codex lee un Review Package compacto antes de tocar diffs, logs o archivos.

• Tú decides qué se fusiona.

El objetivo no es «dejar que un agente edite libremente tu repositorio». El objetivo es la delegación controlada: alcance de tarea pequeño, ejecución aislada, revisión de bajo consumo de tokens y una decisión final controlada por un humano o por Codex.

Por qué existe

Los bucles de codificación largos pueden quemar muchos tokens y enterrar la señal de revisión importante. AgentBridge Local te ofrece un patrón más seguro:

1. Codex divide el trabajo en una tarea acotada.

2. Un agente local lo implementa en un Worktree aislado.

3. El daemon construye un Review Package pequeño: archivos modificados, estadísticas de diff, indicadores de riesgo, informe de alcance, resultado de pruebas y cola de logs.

4. Codex revisa primero el paquete.

5. Solo las tareas riesgosas o poco claras escalan a lecturas enfocadas de diff, archivo o log.

6. Codex o el usuario acepta, rechaza, fusiona, descarta o pide al agente que continúe.

Eso significa que Codex puede permanecer en el asiento costoso y de alto apalancamiento: planificación, control de límites, revisión y aceptación final.

Related MCP server: codex-as-mcp

Lo que obtienes

• Daemon MCP local en http://127.0.0.1:3210/mcp.

• Interfaz de administración web en http://127.0.0.1:3210/.

• Ejecución de MiMo Code a través de las herramientas heredadas mimo_* y la cola de tareas compartida.

• Ejecución de Reasonix TUI a través de las herramientas genéricas agent_*.

• Cola de tareas consciente de agentes que puede ejecutar MiMo y Reasonix en paralelo cuando sus rutas editables no se superponen.

• Admisión de tareas P0 duradera con un marcador de posición persistido, correlación de solicitudes, reintentos idempotentes y un límite de concurrencia de ocho tareas.

• Aislamiento de Git Worktree para los cambios de tareas.

• Alcance de tarea dinámico con límites editables/solo lectura por tarea.

• Protocolo de Review Package de bajo consumo de tokens para la revisión de Codex.

• Bandeja de entrada de recuperación de finalización para que Codex pueda recuperar tareas completadas o fallidas después de una interrupción.

• Perfiles de enrutamiento de modelos para tareas simples, normales, complejas, de alto riesgo y multimodales.

• Adjuntos multimodales de tareas con imágenes pegadas y archivos subidos.

• Acciones seguras de apertura local para carpetas de tareas, carpetas de sesión, sesiones CMD de MiMo, sesiones CMD de Reasonix TUI y visualización del acompañante GUI de Reasonix.

• Instalador ZIP y EXE portátil para Windows con tiempo de ejecución Node incluido.

Cómo funciona

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

Estado actual

AgentBridge Local es un proyecto alfa temprana.

• Sistema operativo objetivo: Windows 10/11 x64.

• Tiempo de ejecución: daemon Node solo en localhost.

• Punto final MCP: http://127.0.0.1:3210/mcp.

• Interfaz de administración: http://127.0.0.1:3210/.

• Distribución: ZIP portátil e instalador EXE con Node incluido.

• MiMo Code y Reasonix no están incluidos; instala e inicia sesión en esas herramientas por separado.

• La validación limpia de Windows y las pruebas comunitarias aún son bienvenidas.

Inicio rápido

Opción A: Usar el instalador de Windows

1. Descarga el último activo de la versión:

   • MiMoBridgeSetup-win10-win11-x64.exe

2. Ejecuta el instalador.

3. Inicia AgentBridge Local desde el lanzador instalado.

4. Abre la interfaz de administración:

   http://127.0.0.1:3210/

5. Configura el MCP de Codex apuntando a:

   http://127.0.0.1:3210/mcp

Opción B: Ejecutar desde el código fuente

Requisitos previos:

• Windows 10/11 x64.

• Git.

• Node.js 18+.

• Codex u otro agente principal compatible con MCP.

• MiMo Code instalado y con sesión iniciada si deseas ejecución de MiMo.

• Reasonix instalado y configurado si deseas ejecución de Reasonix TUI.

Desde la raíz del repositorio:

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

Controles del lanzador:

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 es un límite a nivel de máquina y nunca es expandido por una tarea. El comando allow-root resuelve y valida el directorio, lo desduplica sin distinción de mayúsculas/minúsculas, escribe la configuración activa y, opcionalmente, realiza un reinicio seguro. adopt tiene éxito solo cuando el propietario del puerto localhost, el ejecutable de Node, la entrada del daemon y la identidad de salud coinciden exactamente.

Punto final MCP

Configura Codex para usar:

http://127.0.0.1:3210/mcp

Luego pide a Codex que comience con una tarea acotada, por ejemplo:

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 y agent_start_task persisten y devuelven un marcador de posición antes de la creación del Worktree. Una solicitud nueva exitosa devuelve task_id, request_id, status="preparing_worktree", queue_state e idempotent_replay. Los clientes deben enviar idempotency_key y reutilizarlo después de un tiempo de espera; la misma clave con parámetros diferentes es rechazada.

El inicio de la tarea progresa a través de preparing_worktree -> starting_agent -> running. Un fallo de fase almacena un error_detail estructurado con su request_id, mientras que la cadena heredada error permanece disponible para compatibilidad.

El cliente seguro para versiones utiliza solo módulos integrados de Node y REST, por lo que no requiere node_modules de este árbol de código fuente ni el SDK de MCP:

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

Las distribuciones portátiles e instaladas proporcionan la misma entrada que MiMo Bridge Client.cmd y la ejecutan con el tiempo de ejecución Node incluido.

La habilidad de uso de Codex correspondiente tiene versión bajo skills/use-mimo-bridge-mcp y está incluida en ambas distribuciones. La instalación es explícita para que una habilidad personalizada existente nunca se sobrescriba silenciosamente:

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

El comando realiza una copia de seguridad de una habilidad use-mimo-bridge-mcp existente antes de reemplazarla. Abre una nueva sesión de Codex después si la lista de habilidades ya estaba en caché.

Flujo de la primera tarea

1. Abre la interfaz de administración.

2. Elige el espacio de trabajo y el alcance de la tarea.

3. Selecciona enrutamiento automático o elige MiMo / Reasonix manualmente.

4. Pega el objetivo de la tarea. Puedes pegar capturas de pantalla o subir archivos para tareas multimodales.

5. Deja que el agente se ejecute en un Worktree.

6. Revisa el resultado compacto.

7. Acepta, fusiona, descarta o pide al agente que continúe.

Flujo de revisión de bajo consumo de tokens

AgentBridge Local está construido en torno a la revisión acotada, no a volcados de contexto completos.

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

Agentes compatibles

Modelo de seguridad

AgentBridge Local mantiene intencionalmente un límite de seguridad estrecho:

• El daemon se vincula solo a localhost.

• Las tareas se ejecutan en Git Worktrees.

• allowedRoots a nivel de máquina limita qué carpetas se pueden tocar.

• Los errores de salud y límite del espacio de trabajo exponen solo los metadatos de la configuración activa, una huella digital redactada, recuentos y la ruta normalizada solicitada; nunca enumeran otras raíces permitidas.

• Cada tarea registra su propia instantánea de alcance editable/solo lectura.

• Los cambios fuera del alcance aparecen en los indicadores de riesgo del Review Package.

• Las acciones de apertura del navegador son acciones fijas, no ejecución de comandos arbitrarios.

• Los logs completos, diffs completos, archivos completos y rutas locales sin procesar no son salida de revisión por defecto.

• MiMo y Reasonix no deben fusionar sus propios Worktrees de tareas.

No expongas el daemon a una red pública.

Compilar, probar y empaquetar

Compilar:

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

Ejecutar regresión normal, excluyendo la prueba de integración del ejecutor que se cuelga conocida:

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

Empaquetar:

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

Salidas de versión generadas:

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

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

• artifacts/release-validation.json

Los nombres de los artefactos aún usan la nomenclatura original de MiMoBridge por compatibilidad. El nombre del producto ahora es AgentBridge Local.

Documentación

• README en chino

• Solución de problemas

• Buenos primeros issues

• Lista de verificación para publicación en GitHub

• Notas de la versión v0.1.0-alpha

• Guión de demostración

Documentos de traspaso para mantenedores:

1. PROJECT_MEMORY.md - memoria del proyecto a largo plazo y estado actual de la versión.

2. AGENTS.md - reglas de agentes, flujo de trabajo de colaboración y comandos.

3. docs/HANDOVER_STATUS.md - breve resumen de traspaso actual.

4. docs/OPEN_TASKS.md - trabajo pendiente y riesgos.

5. docs/RELEASE_VALIDATION.md - lista de verificación de validación limpia de Windows.

6. docs/modules/multi-agent-dispatch.md - notas de diseño de múltiples agentes MiMo / Reasonix.

Contribuir

Este proyecto necesita especialmente:

• Validación limpia del instalador ZIP portátil y EXE en Windows 10/11.

• Ejemplos de configuración MCP de Codex.

• Pruebas del flujo de tareas de MiMo y Reasonix.

• Capturas de pantalla de la interfaz de administración y GIFs de demostración.

• Informes de recuperación de fallos más seguros.

• Correcciones de documentación para nuevos usuarios.

• Nuevos adaptadores de agentes locales.

Comienza con CONTRIBUTING.md, docs/GOOD_FIRST_ISSUES.md y SECURITY.md.

Por favor, no incluyas claves API, tokens, credenciales de MiMo, credenciales de Reasonix, logs privados completos, Worktrees locales o rutas personales sin redactar en issues o pull requests.

Licencia

MIT. Consulta LICENSE.