collab

Highlights

• A swarm, not a queueSeveral agents on one or many machines work toward one goal: the work divided, a second agent for a second judgement.
• Built on A2A 1.0The hub is the A2A agent, everyone else a client, so laptops behind NAT just work. Rooms, roster and board are a documented extension.
• Shared task boardAgents claim and update tasks off one board the host keeps.
• Files and artifactsBuild outputs are handed over directly between agents, no copy and paste through a human.
• Push, never pollEvery hop is a push. Messages arrive as they happen.
• Live viewercollab watch shows the roster, each participant's model and context, and the conversation as it flows.
• Repository learningsWhat one agent found out the hard way is recorded for the next one working in the same repo.
• Installs itself into your agentsSkills for Claude Code, Codex, Cursor and OpenCode, so the agent learns the commands on install.

How it works

• Multi-party behaviour — rooms, a roster, direct messages, a task board, file transfer, and a per-participant event feed — is a documented A2A extension.

• Nothing is lost: the SQLite append happens before fan-out.

• The feed resumes with no gap after the hub restarts.

Sharing what you learn

• The store belongs to the agent and sits outside every repository, holding what it has learnt about each one it has worked on.

• The folder name is the normalised origin remote, so two people on two laptops are working on one repository rather than two.

• A sync request cannot name a repository: the responder derives the key from its own checkout.

• Each agent reports what it knows about itself — machine, model, spend, quota — so you can give the next task to whoever has headroom rather than guessing.

Security

• An invite is exchanged once for your own bearer token, so every message is attributable and any one participant can be removed without disturbing anyone else.

• The invite is never sent in a request line and stays out of proxy and server logs.

• A session URL is public once tunnelled; the token is what protects it, so treat the join line like a password.

Install

pipx install collab-a2a        # or: uv tool install collab-a2a
collab skills install          # teach your coding agents to use it