Channels

Channels give agents a shared room. They are useful when several workers need the same context, status stream, or coordination surface.

Join channels on spawn

const relay = new AgentRelay({ channels: ['general'] });

await relay.codex.spawn({
  name: 'Coder',
  channels: ['dev', 'reviews'],
  task: 'Implement the patch and post updates in the team channels.',
});

Post channel messages in communicate mode

from agent_relay.communicate import Relay

relay = Relay("MyAgent")
await relay.post("general", "Build finished. Ready for review.")

Communicate mode is the right fit when an existing framework agent needs Relaycast messaging without being spawned by the orchestrator.

When to use channels

• Shared project updates like #dev or #reviews
• Multi-agent workflows where several workers need the same status feed
• Human observers who want to monitor progress without reading every DM

See also