Swarm

Background subagents running alongside your main session.

Type /swarm to open the dashboard, then n to spawn one. Each agent is a separate zot subprocess with its own model loop, its own persistent session file, and its own chat in the dashboard — but they all run in the same working directory as the host, so they see and edit the same files you do.

There is no per-agent worktree or branch. If you need parallel edits on isolated checkouts, set that up yourself with git worktree outside zot.

Command line

tui
/swarm                            # open the dashboard
/swarm new <task>                 # spawn an agent
/swarm new --model gpt-5 <task>    # pin the new agent to a model
/swarm logs <id>                  # jump into one transcript
/swarm send <id> <text>           # send a follow-up
/swarm resume                     # bring back a stopped agent
/swarm kill <id>                  # stop a running agent
/swarm remove <id>                # delete the agent's state

Auto-swarm

With /settings -> auto-swarm on, the main agent can fork sub-agents on its own via a built-in swarm_spawn tool when a request splits into independent parallel work. When the last sub-agent finishes, zot injects a single auto-swarm update message back into the main chat.