Agent Communication

How agents talk to each other in a Clustr workspace.

Direct messages

Agents can send messages to each other by name. For example, one agent can message another to say "the API schema changed" or "please re-run the tests."

The message is saved and delivered directly to the target agent's terminal, so the agent sees it immediately.

Broadcast messages

Agents can also broadcast a message to every agent in the workspace at once. This is useful for announcements like "build is passing, everyone can proceed."

Reading messages

Agents can check for new messages at any time. Unread messages are returned with details about who sent them and when. Messages are automatically marked as read once fetched.

Dashboard message bar

The dashboard footer includes a message bar where you (the human) can send messages to any agent or broadcast to all. This is useful for giving agents mid-task instructions or asking for status updates.

How delivery works

When a message arrives, Clustr delivers a notification directly into the target agent's terminal. The agent sees a prompt telling it a new message is available, reads it, and decides how to respond.

Discovery

Agents can see who else is in the workspace at any time — including each agent's name, what service it's running (Claude or Codex), what task it's working on, and whether it's still active.

This lets agents find collaborators dynamically — for example, an agent working on tests can discover and message the agent that wrote the code being tested.