Section 01
DesktopClick the Plan Mode icon
TUIShiftTab
When Plan Mode is not active, Swarm will use your Default Model.
In both Desktop and TUI, open /agents to change your models and system-agent model assignments at any time.
Section 02
Work in your current checkout and follow along with Swarm.
Keep changes separate until you are ready to review and integrate them.
Shift+TabTurn on Plan/wt onTurn on WorktreeIn Desktop or TUI, use a durable background task when you want Swarm to work separately while you remain in your current session.
/task <request>Default mode in a worktree
/task plan <request>Plan mode in a worktree
Section 03
Ask Swarm to deploy a system agent when a task benefits from focused research, isolated implementation, or distinct design directions.
Researches repositories and the web, maps architecture and execution paths, and returns evidence-backed findings. Ask Swarm to deploy Finder for a focused research question.
“Use Finders to investigate this bug across multiple areas.”
Implements a dependency-ready scope in an isolated worktree, commits completed changes, and returns a clean handoff. Ask Swarm to deploy Coder for well-defined implementation work.
“Use Coders to implement these independent changes in parallel.”
Creates reusable design variants as managed artifacts by default, or edits an explicit workspace target when repository output is required. Ask Swarm for Designer iterations when you want distinct visual directions to compare.
“Use Designers to create three distinct interface directions.”
Swarm uses these focused helpers behind the scenes.
Condenses context or produces a title in a tool-free, one-shot pass.
Generates concise session titles and portable worktree names, and specializes Iteration Swarm assignments and image briefs inside your approved requirements.
Section 04
Ask Swarm to commit your changes, commit them manually in Desktop or the TUI, or save time with AI Commit.
/commit <message>Commit changes/commit aiAI CommitBring a finished worktree home
Follow the review path from the completed session to your target branch.
Finished sessions that need attention appear here, including worktrees with uncommitted changes and committed changes not yet integrated.
Select Manage beside the Needs Review heading to open Review worktrees for the current workspace.
Swarm compares each worktree with its detected target, keeping dirty or unintegrated work in review and marking safely integrated work as Done.
For a clean, committed worktree, select the offered Integrate into action. Swarm supplies the target from the matching current checkout or the worktree’s managed base branch.
Confirm to integrate only, or choose Integrate and Archive to archive the session only after integration succeeds.
Archive the session after Swarm verifies the worktree is integrated, or use the archive-after-integration option when it is available.