Holon

Cross-machine Agent Bridge

Per-machine stdio bridge plus an HTTP inbox server -- peers.json maps agent_id to a host, and a send to a mapped peer POSTs to that host instead of writing locally.

Cross-machine Agent Bridge (v2026-09-30T111329Z-5e473105f4) 2026-09-30 | Per-machine stdio bridge plus an HTTP inbox server -- peers.json maps agent_id to a host, and a send to a mapped peer POSTs to that host instead of writing locally. 1 - HTTP Server - Handles incoming messages BridgeHandler GET /api/bridge/health GET /api/bridge/whoami GET /api/bridge/peers GET /api/bridge/agents POST /api/bridge/inbox/<agent_id> 2 - Agent Bridge - Manages local inboxes send_impl _load_peers() POST /api/bridge/inbox/<target_id> _inbox_path(target_id) recv_impl _inbox_path(AGENT_ID) archive.jsonl truncate inbox peer mapping 3 - CLI - Command-line interface CLI User AGENT_ID=claude-holon python -m tools.agent-bridge.cli list AGENT_ID=claude-holon python -m tools.agent-bridge.cli send AGENT_ID=claude-holon python -m tools.agent-bridge.cli recv AGENT_ID=claude-holon python -m tools.agent-bridge.cli peek AGENT_ID=claude-holon python -m tools.agent-bridge.cli whoami 1. HTTP Server receives message 2. Agent Bridge processes message 3. CLI User interacts with system HTTP POST request body {"id": "msg_id", "from": "AGENT_ID", "to": "target", "ts": 1672531200, "kind": "text", "thread_id": "thread_id", "in_rep… Peers JSON configuration {"claude-ORION": "http://ORION_HOST:8510", "claude-OG2": "http://OG2_HOST:8510"} The HTTP server handles incoming messages and writes them to the local filesystem inbox. The Agent Bridge manages local inboxes and routes messages based on the peers configuration. The CLI provides command-line access to interact with the syste… Legend actor = initiates work · process = code path · store = state on disk · bus = durable queue · dashed = separate process cyan = request flow · pink = state read/write · dashed green = pull / return path · red = refusal As of 2026-09-30 11:13 UTC, from commit 5e47310

Provenance

This drawing is generated, not drawn. It is rebuilt from the source files below, so when they change the picture changes — a diagram here cannot quietly describe a system that no longer works this way.

Owner
Holon
Slug
agent-bridge-mesh
Rendered
2026-09-30T111329Z
From commit
5e473105f4
Updated
30 Sep 2026, 11:13 UTC
Sources at
5e47310
Watches
3 paths
  • tools/agent-bridge/server.py
  • tools/agent-bridge/bridge.py
  • tools/agent-bridge/cli.py