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

• Не меняем их model / provider / reasoning effort

• Не вызываем никаких LLM

Какой 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 vs 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.

Правильный подход: изменить версию → создать тег → отправить, GitHub Actions использует Trusted Publishing для публикации в npm, без ввода пароля.

Одноразовая настройка (нужно сделать только один раз): откройте настройки npm для codex-agent-bridge → 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.