Agent Bridge

Agent Bridge

A persistent session bridge that lets Claude Code and Codex delegate work to local OMP and Codex agents over MCP.

It is not a one-shot wrapper: you open a delegated-agent session, send one or more messages into it, read the result, reuse it, and close it. Sessions live inside the MCP server process — there is no background daemon, no web UI, and no network listener. Each client launches its own server; when the client exits, its sessions are cleaned up with it.

Works on macOS, Linux, and Windows.

Requirements

• Node.js 20+
• An MCP client: Claude Code or Codex
• The backend(s) you delegate to, launchable on PATH: omp, codex, and/or claude

Agent Bridge only bridges to OMP, Codex, and Claude — it does not install them. Install at least the backend you plan to use, then confirm it is detected:

node scripts/agent-bridge.mjs doctor

doctor prints ok for each backend it finds and flags anything missing. Override a binary path with OMP_BIN / CODEX_BIN / CLAUDE_BIN if it lives somewhere unusual.

Install

Pick one method, then restart the client so the tools (and skill) load:

• Claude Code — one-shot (recommended): method B installs the MCP server and the skill together in a single step (claude plugin install, or /plugin install in-app). You do not install the two separately.
• Codex, or tools-only: method A (claude mcp add / codex mcp add) registers just the MCP server (the eight agent_bridge_* tools). Codex has no Claude-Code plugin one-click, so Codex uses A for tools and C to also load the skill.

git clone https://github.com/LeoWang329/agent-bridge.git
cd agent-bridge

A. As an MCP server — simplest, works for both clients

# Claude Code (user scope = available in every project)
claude mcp add agent-bridge --scope user -- node "$PWD/scripts/agent-bridge.mjs" mcp

# Codex
codex mcp add agent-bridge -- node "$PWD/scripts/agent-bridge.mjs" mcp

Run from the repo root so $PWD expands to an absolute path (on Windows cmd, substitute the full path). Verify with claude mcp list / codex mcp list. Remove with claude mcp remove agent-bridge --scope user / codex mcp remove agent-bridge.

B. As a Claude Code plugin — MCP server + skill in one go

claude plugin marketplace add LeoWang329/agent-bridge
claude plugin install agent-bridge@agent-bridge

The repo self-hosts a Claude Code marketplace, so this one install registers the MCP server and the skill — there is no separate skill step. Equivalent inside Claude Code: /plugin marketplace add LeoWang329/agent-bridge then /plugin install agent-bridge@agent-bridge. Manage it later with claude plugin / /plugin; for local development against a working copy: claude --plugin-dir "$PWD".

C. Codex (and other non-plugin MCP clients) — MCP server + skill

Only Claude Code consumes method B's plugin bundle. For Codex — or any other MCP host that reads a per-user skills directory — give it the two pieces separately: the MCP server (the eight tools) via method A, and the skill (the usage guide that teaches the agent when and how to delegate) by linking it into the client's skills directory. Both pieces point straight at this clone, so there is no copied snapshot to go stale.

<REPO> below is the absolute path to this clone (the directory holding scripts/ and skills/).

1. MCP server (tools) — same as method A:

   codex mcp add agent-bridge -- node "<REPO>/scripts/agent-bridge.mjs" mcp
   

2. Skills (usage guides) — this repo ships two skills: agent-bridge (the bridge usage guide) and dev (a companion that orchestrates delegated code dev/review/design/debug by injecting role personas from skills/dev/roles/). The Claude Code plugin (method B) auto-discovers both; a per-user skills dir does not, so link each subdirectory you want. Codex auto-loads any ~/.codex/skills/<name>/SKILL.md on launch, exactly like Claude Code loads ~/.claude/skills/. Use a symlink/junction (not a copy) so they track the repo:

   # macOS / Linux
   ln -s "<REPO>/skills/agent-bridge" ~/.codex/skills/agent-bridge
   ln -s "<REPO>/skills/dev"          ~/.codex/skills/dev          # optional: the dev-role companion
   
   # Windows (PowerShell or cmd) — junction, no admin needed
   cmd /c mklink /J "%USERPROFILE%\.codex\skills\agent-bridge" "<REPO>\skills\agent-bridge"
   cmd /c mklink /J "%USERPROFILE%\.codex\skills\dev"          "<REPO>\skills\dev"
   

   The same one-liner works for any client with a user skills directory — swap ~/.codex for ~/.claude to load a skill in Claude Code without the plugin, etc. Note: under a per-user skills dir there is no plugin namespace, so the companion loads as dev (whereas the Claude Code plugin exposes it as agent-bridge:dev).