Agent Bridge

Codex가 Claude Code와 DeepSeek Harness를 감독합니다. Bridge 자체는 LLM을 호출하지 않습니다.

Codex를 유일한 감독자로 두세요. Claude Code 또는 DeepSeek Harness가 구현을 담당합니다. Codex에서 검토, 확인, 적용하세요.

한 줄 명령어

npx -y codex-agent-bridge

그런 다음 새로운 Codex 세션을 시작하세요. bridge_* 도구가 보일 것입니다.

이 명령어는: 런타임을 ~/.agent-bridge에 설치하고, Codex Skill과 MCP를 작성하며(로컬 node.exe 사용, npx.cmd 사용 안 함), doctor를 한 번 실행합니다.

업데이트는 같은 명령어를 다시 실행하세요. 제거:

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

--purge는 ~/.agent-bridge를 삭제합니다.

사전 준비 사항

우리가 관리하지 않는 것

• Claude Code / DeepSeek Harness 설치를 도와주지 않음

• 모델 / provider / reasoning effort를 변경하지 않음

• 어떤 LLM도 호출하지 않음

Worker가 있으면 해당 Worker를 할당할 수 있습니다. 하나도 없으면 doctor가 표시합니다.

Related MCP server: cc-agent

기능 설명

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

폐쇄 루프:

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

Turn 종료 ≠ 작업 완료. Diff는 baseCommit과 worktree만 인식합니다.

bridge_run은 worker만 선택합니다: claude 또는 deepseek(디버깅 시 replay / fake 사용 가능). model / provider / effort를 전달하지 마세요.

DeepSeek Harness가 일반적인 경로에 없으면 AGENT_BRIDGE_DEEPSEEK_ROOT를 설정하세요.

사용 시 주의사항

• 대상은 독립적인 git 저장소여야 합니다. 매 bridge_* 호출마다 동일한 project를 전달하세요. 작업 UUID 필드명은 task입니다.

• 동일 프로젝트에서 동시에 하나의 Writer만 허용됩니다. 두 번째 작성자는 CORE_LOCK_HELD를 반환합니다.

• MCP를 변경한 후에는 반드시 새 Codex 세션을 시작해야 합니다. 이전 세션에서는 새 도구를 볼 수 없습니다.

• 손상된 tasks.json은 TASK_STORE_CORRUPTED를 반환하며, 빈 저장소로 처리되지 않습니다.

새 버전 배포

로컬에서 npm publish를 실행할 때마다 2FA가 필요합니다. 이는 npm의 규정이며, git push처럼 비밀번호 없이 할 수 없습니다.

올바른 방법: 버전 변경 → 태그 생성 → push, GitHub Actions가 Trusted Publishing을 사용하여 npm에 배포하며, 비밀번호 입력이 필요 없습니다.

일회성 설정(한 번만 수행): codex-agent-bridge의 npm 설정 열기 → Trusted Publisher → GitHub Actions, 다음 입력:

이후 매번:

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

소스 코드로 개발

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

--dev는 MCP가 ~/.agent-bridge 대신 현재 저장소를 가리키도록 합니다.

문서

저장소 디렉토리 이름은 여전히 Agent Relay일 수 있습니다. 제품명은 Agent Bridge입니다. npm 패키지명은 codex-agent-bridge입니다.