dsh-intercom

Running multiple dsh sessions side by side on the same machine—say a planner, a worker, and a reviewer—yet having no built-in way for them to talk to each other is the most immediate friction in local multi-agent workflows. dsh-intercom solves exactly that: it auto-spawns a lightweight local broker (via a unix socket or a Windows named pipe) so sessions in any two independent dsh processes can discover each other and exchange messages, with no cross-host networking or external message bus required.

Capabilities span three layers. Discovery: list and list-cwd show every live session on the machine with its name, working directory, model, and real-time state (idle, thinking, tool). Messaging: send is fire-and-forget, with mailbox queueing so a message to a briefly offline named peer is delivered automatically when that peer reconnects; ask/reply is a blocking request-reply that guarantees the sender waits for an answer before continuing. Addressing: each session can take a stable alias, and peers resolve by alias, full session id, or unique prefix. Installing the plugin also registers a coordination skill automatically, offering planner-worker playbooks and send-versus-ask guidance with zero extra steps. In the web profile, a dedicated Intercom page in the Settings panel lists the live roster and lets you send a message as any session hosted by that process.

This plugin is for developers who orchestrate multi-agent workflows on a single workstation: when a planner needs to dispatch a task to a worker, the worker needs to ask the planner for the next step, or sessions need to pass context back and forth, this local interconnect makes multi-session collaboration feel as natural as in-process thread communication—without pulling in Redis, RabbitMQ, or a sidecar HTTP service.