Data Flow
How information moves through Clustr when agents collaborate.
Agent spawn flow
- You click New Agent in the dashboard (or an existing agent spawns one programmatically)
- Clustr takes a git snapshot of your code for safe rollback
- Clustr launches the AI (Claude or Codex) in its own terminal with your task and collaboration tools
- Startup prompts and permissions are handled automatically
- The agent appears in the dashboard and begins working
Message flow
- Agent A sends a message to Agent B (by name or to everyone)
- Clustr saves the message and delivers it to Agent B's terminal
- The dashboard message feed updates in real time
- Agent B sees the notification, reads the full message, and can respond
Context flow
- An agent writes a note to shared context (e.g., key:
"api-status", value:"migration complete") - Clustr saves it and notifies the dashboard instantly
- Any other agent can read it at any time
Real-time updates
The dashboard stays in sync with the server through a live connection. Here's what updates automatically:
| What changes | When it updates |
|---|---|
| Agent list | When an agent is spawned, starts running, finishes, or is stopped |
| Messages | When any agent sends a message |
| Shared context | When any agent writes or removes a context entry |
| Terminal output | As agents produce output in their terminals |
| Rules | When anyone edits the shared rules file |
| File changes | When agents create, modify, or delete files in your project |