AgentBridge Local

English | 简体中文

이전 명칭 MiMo Bridge MCP.

AgentBridge Local은 로컬 우선 MCP 오케스트레이션 콘솔로, Codex가 리뷰 제어권을 포기하지 않고 MiMo Code, Reasonix TUI 및 향후 로컬 코딩 에이전트를 조정할 수 있게 합니다.

Codex는 계획, 아키텍처 및 리뷰에 능숙합니다. 로컬 코딩 에이전트는 긴 구현 루프에 유용합니다. AgentBridge Local은 이러한 작업을 분리합니다:

• Codex가 계획하고 리뷰합니다.

• MiMo / Reasonix가 제한된 작업을 실행합니다.

• 모든 작업은 Git Worktree 내에서 실행됩니다.

• Codex는 diff, 로그 또는 파일을 건드리기 전에 간결한 리뷰 패키지를 읽습니다.

• 사용자가 병합할 내용을 결정합니다.

목표는 "에이전트가 저장소를 자유롭게 편집하도록 두는 것"이 아닙니다. 목표는 통제된 위임입니다: 작은 작업 범위, 격리된 실행, 낮은 토큰 리뷰, 그리고 사람 또는 Codex가 통제하는 최종 결정.

존재 이유

긴 코딩 루프는 많은 토큰을 소모하고 중요한 리뷰 신호를 묻을 수 있습니다. AgentBridge Local은 더 안전한 패턴을 제공합니다:

1. Codex가 작업을 제한된 범위로 분할합니다.

2. 로컬 에이전트가 격리된 Worktree에서 구현합니다.

3. 데몬이 작은 리뷰 패키지를 빌드합니다: 변경된 파일, diff 통계, 위험 플래그, 범위 보고서, 테스트 결과 및 로그 테일.

4. Codex가 먼저 패키지를 리뷰합니다.

5. 위험하거나 불명확한 작업만 집중 diff, 집중 파일 또는 제한된 로그 읽기로 에스컬레이션됩니다.

6. Codex 또는 사용자가 수락, 거부, 병합, 폐기하거나 에이전트에게 계속 진행을 요청합니다.

이는 Codex가 비용이 많이 들고 영향력이 큰 자리, 즉 계획, 경계 제어, 리뷰 및 최종 수락에 머물 수 있음을 의미합니다.

Related MCP server: codex-as-mcp

제공 기능

• 로컬 MCP 데몬 at http://127.0.0.1:3210/mcp.

• 브라우저 관리 UI at http://127.0.0.1:3210/.

• MiMo Code 실행 레거시 mimo_* 도구 및 공유 작업 큐를 통해.

• Reasonix TUI 실행 일반 agent_* 도구를 통해.

• 에이전트 인식 작업 큐 편집 가능한 경로가 겹치지 않을 때 MiMo와 Reasonix를 병렬로 실행 가능.

• 지속성 P0 작업 수락 유지된 플레이스홀더, 요청 상관관계, 멱등성 재시도 및 8개 작업 동시성 상한 포함.

• Git Worktree 격리 작업 변경 사항용.

• 동적 작업 범위 작업별 편집 가능/읽기 전용 경계 포함.

• 저토큰 리뷰 패키지 프로토콜 Codex 리뷰용.

• 완료 복구 받은 편지함 Codex가 중단 후 완료되거나 실패한 작업을 복구할 수 있도록 함.

• 모델 라우팅 프로필 단순, 일반, 복합, 고위험 및 멀티모달 작업용.

• 멀티모달 작업 첨부 파일 붙여넣은 이미지 및 업로드된 파일 포함.

• 안전한 로컬 열기 작업 작업 폴더, 세션 폴더, MiMo CMD 세션, Reasonix TUI CMD 세션 및 Reasonix GUI 컴패니언 보기용.

• Windows 휴대용 ZIP 및 EXE 설치 프로그램 번들 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은 초기 알파 프로젝트입니다.

• 대상 OS: Windows 10/11 x64.

• 런타임: localhost 전용 Node 데몬.

• MCP 엔드포인트: http://127.0.0.1:3210/mcp.

• 관리 UI: http://127.0.0.1:3210/.

• 배포: 번들 Node가 포함된 휴대용 ZIP 및 EXE 설치 프로그램.

• MiMo Code 및 Reasonix는 번들되지 않음; 해당 도구를 별도로 설치하고 로그인하세요.

• 깨끗한 Windows 검증 및 커뮤니티 테스트는 여전히 환영합니다.

빠른 시작

옵션 A: Windows 설치 프로그램 사용

1. 최신 릴리스 에셋 다운로드:

   • MiMoBridgeSetup-win10-win11-x64.exe

2. 설치 프로그램 실행.

3. 설치된 런처에서 AgentBridge Local 시작.

4. 관리 UI 열기:

   http://127.0.0.1:3210/

5. Codex MCP 구성 포인트:

   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 실행 파일, 데몬 진입점 및 상태 ID가 모두 정확히 일치할 때만 성공합니다.

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 단계로 진행됩니다. 단계 실패는 request_id와 함께 구조화된 error_detail을 저장하며, 레거시 문자열 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. 관리 UI 열기.

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가 접근 가능한 폴더를 제한합니다.

• 상태 및 작업 공간 경계 오류는 활성 구성 메타데이터, 수정된 지문, 개수 및 요청된 정규화된 경로만 노출합니다; 다른 허용된 루트를 열거하지 않습니다.

• 각 작업은 자체 편집 가능/읽기 전용 범위 스냅샷을 기록합니다.

• 범위 외 변경 사항은 리뷰 패키지 위험 플래그에 나타납니다.

• 브라우저 열기 작업은 고정된 작업이며 임의의 명령 실행이 아닙니다.

• 전체 로그, 전체 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 검증.

• Codex MCP 설정 예제.

• MiMo 및 Reasonix 작업 흐름 테스트.

• 관리 UI 스크린샷 및 데모 GIF.

• 더 안전한 장애 복구 보고서.

• 새 사용자를 위한 문서 수정.

• 새 로컬 에이전트 어댑터.

CONTRIBUTING.md, docs/GOOD_FIRST_ISSUES.md 및 SECURITY.md로 시작하세요.

이슈나 풀 리퀘스트에 API 키, 토큰, MiMo 자격 증명, Reasonix 자격 증명, 전체 개인 로그, 로컬 Worktree 또는 수정되지 않은 개인 경로를 포함하지 마십시오.

라이선스

MIT. LICENSE 참조.