AgentBridge Local

English | 简体中文

Ранее MiMo Bridge MCP.

AgentBridge Local — это локальная консоль оркестрации MCP, которая позволяет Codex координировать работу MiMo Code, Reasonix TUI и будущих локальных агентов кодирования, не отказываясь от контроля над ревью.

Codex отлично справляется с планированием, архитектурой и ревью. Локальные агенты кодирования полезны для длительных циклов реализации. AgentBridge Local разделяет эти задачи:

• Codex планирует и ревьюирует.

• MiMo / Reasonix выполняют ограниченные задачи.

• Каждая задача выполняется внутри Git Worktree.

• Codex сначала читает компактный Review Package, прежде чем касаться diff, логов или файлов.

• Вы решаете, что будет объединено.

Цель — не «позволить агенту свободно редактировать ваш репозиторий». Цель — контролируемое делегирование: небольшой объем задачи, изолированное выполнение, ревью с низким расходом токенов и окончательное решение, принимаемое человеком или Codex.

Зачем это нужно

Длинные циклы кодирования могут сжигать много токенов и скрывать важный сигнал для ревью. AgentBridge Local предлагает более безопасный подход:

1. Codex разбивает работу на ограниченную задачу.

2. Локальный агент реализует её в изолированном Worktree.

3. Демон собирает компактный Review Package: изменённые файлы, статистика diff, флаги риска, отчёт об объеме, результат тестов и хвост лога.

4. Codex сначала просматривает пакет.

5. Только рискованные или неясные задачи требуют целенаправленного чтения diff, файлов или ограниченного лога.

6. Codex или пользователь принимает, отклоняет, объединяет, отбрасывает задачу или просит агента продолжить.

Это означает, что Codex может оставаться на дорогом и высокоэффективном месте: планирование, контроль границ, ревью и окончательное принятие.

Related MCP server: codex-as-mcp

Что вы получаете

• Локальный демон MCP по адресу http://127.0.0.1:3210/mcp.

• Веб-интерфейс администратора по адресу http://127.0.0.1:3210/.

• Выполнение MiMo Code через устаревшие инструменты mimo_* и общую очередь задач.

• Выполнение Reasonix TUI через общие инструменты agent_*.

• Очередь задач с поддержкой агентов, которая может выполнять MiMo и Reasonix параллельно, если их редактируемые пути не пересекаются.

• Устойчивый приём задач P0 с постоянным заполнителем, корреляцией запросов, идемпотентными повторными попытками и ограничением на восемь одновременных задач.

• Изоляция Git Worktree для изменений задачи.

• Динамический объем задачи с редактируемыми/только для чтения границами для каждой задачи.

• Протокол Review Package с низким расходом токенов для ревью Codex.

• Инбокс восстановления завершённых задач, чтобы Codex мог восстановить завершённые или неудачные задачи после прерывания.

• Профили маршрутизации моделей для простых, обычных, сложных, высокорисковых и мультимодальных задач.

• Мультимодальные вложения задач с вставленными изображениями и загруженными файлами.

• Безопасные действия локального открытия для папок задач, папок сессий, сессий MiMo CMD, сессий Reasonix TUI CMD и просмотра компаньона Reasonix GUI.

• Портативный ZIP и установщик EXE для Windows со встроенной средой выполнения Node.

Как это работает

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

Текущий статус

AgentBridge Local — это проект ранней альфа-версии.

• Целевая ОС: Windows 10/11 x64.

• Среда выполнения: демон Node только для localhost.

• MCP эндпоинт: http://127.0.0.1:3210/mcp.

• Веб-интерфейс администратора: http://127.0.0.1:3210/.

• Распространение: портативный ZIP и установщик EXE со встроенным Node.

• MiMo Code и Reasonix не входят в комплект; устанавливайте и входите в эти инструменты отдельно.

• Чистая проверка Windows и тестирование сообществом всё ещё приветствуются.

Быстрый старт

Вариант A: Использовать установщик Windows

1. Загрузите последний релизный артефакт:

   • MiMoBridgeSetup-win10-win11-x64.exe

2. Запустите установщик.

3. Запустите AgentBridge Local из установленного лаунчера.

4. Откройте веб-интерфейс администратора:

   http://127.0.0.1:3210/

5. Настройте конфигурацию MCP Codex на:

   http://127.0.0.1:3210/mcp

Вариант B: Запуск из исходников

Предварительные требования:

• Windows 10/11 x64.

• Git.

• Node.js 18+.

• Codex или другой главный агент с поддержкой MCP.

• MiMo Code установлен и выполнен вход, если требуется выполнение MiMo.

• Reasonix установлен и настроен, если требуется выполнение Reasonix TUI.

Из корня репозитория:

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

Управление лаунчером:

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 — это граница на уровне машины и никогда не расширяется задачей. Команда allow-root разрешает и проверяет каталог, дедуплицирует его без учёта регистра, записывает активную конфигурацию и, при необходимости, выполняет безопасный перезапуск. adopt успешно выполняется только тогда, когда владелец порта localhost, исполняемый файл Node, точка входа демона и идентификатор здоровья полностью совпадают.

MCP эндпоинт

Настройте Codex на использование:

http://127.0.0.1:3210/mcp

Затем попросите Codex начать с ограниченной задачи, например:

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 и agent_start_task сохраняются и возвращают заполнитель до создания Worktree. Успешный новый запрос возвращает task_id, request_id, status="preparing_worktree", queue_state и idempotent_replay. Клиенты должны отправлять idempotency_key и повторно использовать его после таймаута; тот же ключ с другими параметрами отклоняется.

Запуск задачи проходит через стадии preparing_worktree -> starting_agent -> running. Сбой фазы сохраняет структурированную error_detail с её request_id, в то время как устаревшая строка error остаётся доступной для совместимости.

Безопасный для релиза клиент использует только встроенные модули Node и REST, поэтому ему не требуется node_modules этого дерева исходников или MCP SDK:

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

Портативные и установленные дистрибутивы предоставляют ту же точку входа как MiMo Bridge Client.cmd и запускают её со встроенной средой выполнения Node.

Соответствующий навык использования Codex версионирован в skills/use-mimo-bridge-mcp и включён в оба дистрибутива. Установка явная, чтобы существующий настроенный навык никогда не был перезаписан молча:

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

Команда создаёт резервную копию существующего навыка use-mimo-bridge-mcp перед заменой. Откройте новую сессию Codex после этого, если список навыков уже был кэширован.

Поток первой задачи

1. Откройте веб-интерфейс администратора.

2. Выберите рабочее пространство и объём задачи.

3. Выберите автоматическую маршрутизацию или выберите MiMo / Reasonix вручную.

4. Вставьте цель задачи. Вы можете вставить скриншоты или загрузить файлы для мультимодальных задач.

5. Дайте агенту выполнить задачу в Worktree.

6. Просмотрите компактный результат.

7. Примите, объедините, отбросьте или попросите агента продолжить.

Рабочий процесс ревью с низким расходом токенов

AgentBridge Local построен вокруг ограниченного ревью, а не полной выгрузки контекста.

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

Поддерживаемые агенты

Модель безопасности

AgentBridge Local намеренно поддерживает узкую границу безопасности:

• Демон привязывается только к localhost.

• Задачи выполняются в Git Worktree.

• allowedRoots на уровне машины ограничивает, какие папки могут быть затронуты.

• Ошибки состояния здоровья и границ рабочего пространства раскрывают только метаданные активной конфигурации, обезличенный отпечаток, счётчики и запрошенный нормализованный путь; они никогда не перечисляют другие разрешённые корни.

• Каждая задача записывает свой собственный снимок области редактируемых/только для чтения.

• Изменения вне области отображаются в флагах риска Review Package.

• Действия открытия браузера являются фиксированными действиями, а не произвольным выполнением команд.

• Полные логи, полные diff, полные файлы и необработанные локальные пути не являются результатом ревью по умолчанию.

• MiMo и Reasonix не должны объединять свои собственные Worktree задач.

Не выставляйте демон в публичную сеть.

Сборка, тестирование и упаковка

Сборка:

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

Запуск обычной регрессии, исключая известный зависающий интеграционный тест бегуна:

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

Упаковка:

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

Сгенерированные релизные артефакты:

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

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

• artifacts/release-validation.json

Имена артефактов всё ещё используют оригинальное именование MiMoBridge для совместимости. Название продукта теперь — AgentBridge Local.

Документация

• 中文 README

• Устранение неполадок

• Хорошие первые задачи

• Контрольный список публикации на GitHub

• Примечания к релизу v0.1.0-alpha

• Сценарий демонстрации

Документы передачи мейнтейнеру:

1. PROJECT_MEMORY.md — долгосрочная память проекта и текущее состояние релиза.

2. AGENTS.md — правила агентов, рабочий процесс совместной работы и команды.

3. docs/HANDOVER_STATUS.md — краткое текущее резюме передачи.

4. docs/OPEN_TASKS.md — незавершённые работы и риски.

5. docs/RELEASE_VALIDATION.md — контрольный список чистой проверки Windows.

6. docs/modules/multi-agent-dispatch.md — заметки по дизайну мультиагента MiMo / Reasonix.

Вклад в проект

Этот проект особенно нуждается в:

• Чистой проверке установщика Windows 10/11 и портативного ZIP.

• Примерах настройки MCP Codex.

• Тестировании потоков задач MiMo и Reasonix.

• Скриншотах веб-интерфейса администратора и демонстрационных GIF.

• Отчётах о более безопасном восстановлении после сбоев.

• Исправлениях документации для новых пользователей.

• Новых адаптерах локальных агентов.

Начните с CONTRIBUTING.md, docs/GOOD_FIRST_ISSUES.md и SECURITY.md.

Пожалуйста, не включайте API-ключи, токены, учётные данные MiMo, учётные данные Reasonix, полные приватные логи, локальные Worktree или необезличенные личные пути в issues или pull requests.

Лицензия

MIT. См. LICENSE.