# Multi-Agent Tunnel

Build a brokered agent runtime, not direct model-to-model chat.

Core idea:

- `MCP` = pull layer: agents read shared context/tools/tasks. - `Broker` = push layer: wakes adapters when new events arrive. - `Adapters` = vendor-specific runtimes for Codex, Claude, Gemini. - `Artifacts` = shared durable state: Git branches, files, logs, PRs. - `Protocol` = normalized event envelope, optionally A2A-compatible.

```text ┌──────────────────────────┐ │ User / UI │ └────────────┬─────────────┘ │ ▼ ┌──────────────────────────┐ │ Agent Orchestrator │ │ task routing / policy │ └────────────┬─────────────┘ │ push events ▼ pull tools/context ┌──────────────────────────────────────────┐ │ Agent Tunnel / Message Bus │ │ Redis Streams / NATS / Postgres / etc │ └───────┬──────────────┬──────────────┬────┘ │ │ │ ▼ ▼ ▼ ┌────────────┐ ┌─────────────┐ ┌─────────────┐ │ Codex │ │ Claude │ │ Gemini │ │ Adapter │ │ Adapter │ │ Adapter │ └─────┬──────┘ └──────┬──────┘ └──────┬──────┘ │ │ │ ▼ ▼ ▼ ┌────────────┐ ┌─────────────┐ ┌─────────────┐ │ Codex CLI │ │ Claude Code │ │ Gemini CLI │ └─────┬──────┘ └──────┬──────┘ └──────┬──────┘ │ │ │ └────────┬───────┴───────┬────────┘ ▼ ▼ ┌──────────────────┐ ┌──────────────────┐ │ Shared MCP Server│ │ Shared Arti