Boss and worker agents: running several agents at once

Why delegate to workers?

A boss session can hand work to worker agents that run in parallel. Instead of one agent doing everything in sequence, you split a big job into independent tasks and let several agents work at the same time — then merge the results.

Each worker gets its own copy

Every worker runs in its own isolated copy of the project (a git worktree), so workers never overwrite each other. When a worker finishes, the boss merges its work back into the main copy — cleanly, with conflicts surfaced rather than silently lost.

How it works in practice

1. Promote a session to boss.
2. The boss spawns workers and gives each a self-contained task.
3. Workers run in parallel, each visible as its own pane.
4. The boss merges each finished worker back in.

This is how Granular tackles large builds overnight — many small tasks, in parallel, reconciled at the end.

Related