Skip to main content

agent-bridge

Let your coding agents work together. Ask one to give another a task, review the result, and report back—all from the same terminal.

Supports Claude Code, Codex, Muse, OpenCode, Pi, Oh My Pi, and Cursor.

Install

Requires Python 3.12+. Install and sign in to the agents you want to use, then choose one:

pip install agent-bridge-orchestrator
# or
pipx install agent-bridge-orchestrator
# or
uv tool install agent-bridge-orchestrator

With pip or pipx, install a suitable Python first; uv can download it for you.

Get started

cd ~/projects/app
bridge claude

Then ask:

Ask Codex through the bridge to add a --json flag to src/cli.py. Review its changes and report back.

Bridge installs the agent instructions and starts Codex when needed. Later requests reuse its conversation. You can also launch bridge codex, bridge muse, bridge opencode, bridge pi, bridge omp, or bridge cursor.

Use it from your terminal

Run bridge setup once to install the agent instructions, then send a request. --from me names you as the sender:

bridge setup
bridge ask --from me --to codex "Review this project"

To send work now and collect the answer later:

id=$(bridge send --from me --to muse "Review the tests")
bridge wait --from me "$id"

Each background agent handles one task at a time and keeps its conversation. Add --new-session to ask or send for a fresh start. Add --timeout 60 to ask or wait to stop waiting after a minute; the work continues.

Command Purpose
bridge agents List connected agents.
bridge watch Follow the conversation.
bridge tasks --from me Inspect your task history; add --json for scripts.
bridge cancel --from me ID Cancel a running Codex app-server task.
bridge stop AGENT Stop a background agent.
bridge doctor [AGENT] Diagnose startup problems without changing files.
bridge upgrade Update Bridge and refresh its skills.

For all commands and options—including broadcasts, progress notes and configured workers—see the command reference or bridge --help.

Discuss a decision together

bridge roundtable --from me --agents claude,codex,muse --moderator claude \
  "Compare the proposed designs and recommend one. Preserve disagreements."

Participants read one another's contributions before the moderator writes a report. Discussions are for analysis, with bounded rounds and time limits; they do not authorize implementation. See roundtables for participant rules, timeouts and partial results.

Work on several projects

Give each project its own workspace:

bridge --workspace app claude
# From another terminal in the same project:
bridge --workspace app ask --from me --to codex "Review this project"

Workspaces keep agents, sessions and messages separate. They do not make separate copies of your files. Without a workspace, projects share the default bus. See workspace settings.

Skills and settings

bridge setup installs five skills for all seven supported agents:

  • bridge: exchange messages and delegate work.
  • bridge-roundtable: run discussions and summarize decisions.
  • bridge-tasks: inspect history, recover replies and cancel supported tasks.
  • bridge-workspaces: keep projects separate.
  • bridge-setup: install, diagnose and configure agents.

Interactive launch and bridge upgrade refresh them too. The skills guide explains how to invoke them in each agent.

Use bridge start AGENT --model MODEL --effort VALUE to run a configured worker in the foreground. Model names, effort levels and permissions depend on the agent; see agent settings. Background OpenCode grants permission requests, and background Cursor uses --force.

Development

Python standard library only at runtime.

uv sync
make check   # lint, type checking and tests
make fmt     # format and apply automatic fixes

Use uv tool install --editable . to run your checkout.

Contributing · Changelog · Technical reference

MIT license.

Metadata

Release files for agent-bridge-orchestrator 0.4.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for agent-bridge-orchestrator 0.4.0
File Size Uploaded Provenance Actions
agent_bridge_orchestrator-0.4.0.tar.gz 64.9 kB Without provenance Details for agent_bridge_orchestrator-0.4.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for agent-bridge-orchestrator 0.4.0
File Interpreter ABI Platform Actions
agent_bridge_orchestrator-0.4.0-py3-none-any.whl Python 3 none any Details for agent_bridge_orchestrator-0.4.0-py3-none-any.whl

Total release size: 145.0 kB

Release files / agent_bridge_orchestrator-0.4.0.tar.gz

Download URL agent_bridge_orchestrator-0.4.0.tar.gz
Size 64.9 kB
Tags Source
SHA-256 checksum
How to use checksums
3c695a2d423bd53b32a227dfbab21ac97c769b73fa70284add3f95ece54b4067
BLAKE2b-256 checksum
How to use checksums
641da411940bf744e5850efdb4f274fdc06bfdaf544514735b5ce81651c29bed
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / agent_bridge_orchestrator-0.4.0-py3-none-any.whl

Download URL agent_bridge_orchestrator-0.4.0-py3-none-any.whl
Size 80.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8fdcb8d4f4f6b350842c93788f65cbe9f56fd443076fe5e180b1c65f1c2f93cf
BLAKE2b-256 checksum
How to use checksums
7ecd03c97811ffb6eadc469c5f648f0a0a7ccdf44576a16c938492bb2364aac1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for agent-bridge-orchestrator 0.4.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page