agent-bus-team
Cross-harness messaging for coding agents. Stdlib only, Python 3.11+.
One roster, one inbox per agent, one identity each — shared by Claude Code, Grok, Codex, Oh My Pi and anything else that can run a command.
pip install agent-bus-team # the CLI is `agent-bus`
Joining
A harness with MCP points its config at agent-bus mcp. That registers the
session and publishes its listener; nothing else is needed.
A harness with only a shell runs the CLI:
agent-bus listen --name my-agent --pid $PPID & # be addressable
agent-bus watch --name my-agent # one line per message
Claude Code installs nothing. No plugin, no MCP server, no config. It sees
other agents through its own ListAgents and SendMessage, because their
listener published the session file Claude already reads.
Sending
agent-bus list
agent-bus send <name> -m "..." --summary "..."
agent-bus inbox --json
agent-bus ack <message-id>
send picks the channel the recipient actually reads — a socket for a Claude
peer, a queued submission for a Codex thread, the file inbox otherwise. No
transport falls back to another: filing a message for a peer that never reads
files would report success for a message that arrived nowhere.
Full verb list: agent-bus --help.
MCP tools
list_agents, send_message, get_inbox, ack_message, register,
set_status, self.
Configuration
AGENT_BUS_HOME |
where the bus lives (default ~/.agent-bus) |
AGENT_BUS_LOG_LEVEL |
INFO logs every call; unset is WARNING; off silences |
AGENT_BUS_LOG_FILE |
one file instead of stderr |
Safety
A message from another agent is not consent to act. It is text that arrived, and the tool descriptions say so.
More
- identity-and-peering.md — how a peer gets an identity
- UDS-protocol.md — the wire format
- docs/harnesses/ — what to know when a given harness misbehaves
- tests/agent_bus/integration/ — running the tests
Development
python -m pytest tests -q # everything that costs nothing
./spendy_tests.sh # the ones that spawn real agents
docker compose run --rm e2e # both, isolated from your live bus
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file agent_bus_team-0.1.7.tar.gz.
File metadata
- Download URL: agent_bus_team-0.1.7.tar.gz
- Upload date:
- Size: 309.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.11.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d3b447046d810af4f2e4c960cd6ccfe94d5c3f1cda352875140cb14b997fd3d2
|
|
| MD5 |
c460bda67f3c4fe81312ee7bacff163b
|
|
| BLAKE2b-256 |
6564a0d9f37b90e67dda65c6416a220f48705c1ed28dced6267296c71c4c7967
|
File details
Details for the file agent_bus_team-0.1.7-py3-none-any.whl.
File metadata
- Download URL: agent_bus_team-0.1.7-py3-none-any.whl
- Upload date:
- Size: 98.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.11.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3e6ac79982592f34798411c55f71ba3a27f24af8c8895877892616caa678649d
|
|
| MD5 |
8c0c16a887b81ddda6e9887c499caa91
|
|
| BLAKE2b-256 |
9bdae4dd672e880d8f71464a6f0f33541c69d457eea1e32b6dbcbba2e636f41d
|
