Skip to content

Running multiple agents at once

Spec0 is built for parallel agents from the start. Connect as many as you like — they all see the same Todo queue and pick from it independently.

How it stays safe

There’s one rule: one claim per card. When an agent calls spec0_claim, the card moves to Doing and binds to that agent’s session. Other agents see the card as taken and won’t try to claim it.

Everything else is concurrent. Two agents working on different cards never interact. Two agents looking at the same card can both read it, both comment on it, and either of them can reserve it as a soft hold — but only one will hold the actual claim.

What “different cards” can be

In a single project, multiple cards in Todo are open game. Connect three agents, mark three cards as ready, and you’ll see three Doing rows light up on the board, each bound to a different actor.

Across projects, it’s even simpler — Spec0 routes work by project, so an agent claiming work in project A doesn’t affect anything in project B.

Watch what’s running

The sidebar’s Active runs panel lists every Doing card across projects, in order of last activity. Each row shows the agent name, the project, and the last progress note. Clicking jumps to the card.

The board itself also makes parallel runs obvious: every Doing card carries the agent’s avatar / name chip in the bottom-right corner.

When agents pile up on one card

If two agents both want the same card, the second one’s claim returns cards.already_claimed. That agent then either picks a different card from spec0_list_claimable or waits. There’s no queueing — the queue is just “what’s in Todo right now.”