Show and tell: opencode-plugin-peers — cross-session messaging for OpenCode

[jkrandom-sudo]

Hi everyone — I’m the author of opencode-plugin-peers, an open-source plugin that adds local cross-session messaging to OpenCode.

oh-my-openagent already provides powerful orchestration inside agent workflows. This plugin focuses on a different boundary: communication between independent OpenCode processes running in separate terminals, repositories, worktrees, or tasks.

For example, one session can investigate a failure while another implements the fix, and they can hand conclusions directly to each other without manually copying context between windows.

Current features include:

• list_agents and send_message tools for peer discovery and messaging
• /peers, /peers-name, /peers-inbox, and /peers-outbox commands
• Delivery while the receiving session is busy
• Durable queues, final delivery acknowledgements, and restart recovery
• Independently addressable root and child sessions
• Inbound policies: accept, auto, hold, and refuse
• Permission modes for peer-triggered turns
• Local-only transport through Unix-domain sockets on macOS/Linux and loopback TCP on Windows

Install:

opencode plugin -g opencode-plugin-peers

It currently requires OpenCode 1.18.0 or later and Node.js 18 or later.

GitHub:
https://github.com/jkrandom-sudo/opencode-plugin-peers

npm:
https://www.npmjs.com/package/opencode-plugin-peers

I’m especially interested in feedback from oh-my-openagent users:

• Would cross-process handoffs complement your current multi-agent workflows?
• Are there compatibility concerns with OMO hooks, subagents, or session lifecycle behavior?
• Would an optional integration between the two projects be useful?

For sensitive projects, I recommend starting with peerPermissions: "ask" or inboundPolicy: "hold" and treating peer messages as untrusted input.

This project is independent and is not affiliated with oh-my-openagent. I’m sharing it here to learn whether it solves a useful adjacent workflow and to collect technical feedback.