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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.