📬
UDS Inbox — Inter-Agent Communication
Unix domain sockets for agent-to-agent messaging on the same machine
P2Infrastructure
Summary
Allows agents running on the same machine to communicate over Unix domain sockets. Enables peer discovery between local Claude instances. Part of the broader multi-agent infrastructure alongside Coordinator Mode and Agent Teams.
Architecture Diagram
Technical Details
This is the local communication layer complementing the cloud-based ULTRAPLAN and the in-process Coordinator Mode. Together they form three tiers:
• Local same-process: Coordinator Mode (in-memory)
• Local cross-process: UDS Inbox (Unix sockets)
• Remote: ULTRAPLAN / CCR (cloud containers)
Implementation Pattern
TypeScript (conceptual)
// Three-tier communication architecture
// Tier 1: In-process (Coordinator Mode)
const coordinator = new CoordinatorMode(); // shared memory
// Tier 2: Cross-process (UDS Inbox)
const socket = createUDSSocket('/tmp/claude-agent.sock');
socket.on('message', handlePeerMessage);
// Tier 3: Remote (ULTRAPLAN / CCR)
const ccr = new CloudContainerRuntime(ENDPOINT);Architecture Insight
Three tiers of communication (in-memory, Unix sockets, cloud) map to increasing latency and decreasing coupling. This is a textbook distributed systems pattern applied to AI agents.
Official / Public Basis
Unix domain socket communication layer found in source. Part of multi-agent infrastructure alongside Coordinator Mode.
Governance Concerns
Local inter-process communication needs authentication to prevent unauthorized agent-to-agent messaging. Socket permissions must be restricted.
LightHope Ecosystem Mapping
LightHope — inter-service communication for Docker-based ecosystem, local agent coordination, message-passing patterns for V5.3 containerized services