Product guide
HangarSwarm guide
Run many agents at once in isolated worktrees, with a quality check before each merge.
What it is
HangarSwarm runs several agents at once, each in its own isolated copy of your project (a git worktree). Every agent's work has to pass a quality check before it is merged, so a broken change never lands. HangarSwarm is a paid feature.
Before you start
- Hangarvibe, signed in with an active subscription.
- A project folder. It does not need to be a git project — HangarSwarm sets up git for you if needed.
How to use it
- 1
Open HangarSwarm with Ctrl+Shift+S.
- 2
Type a branch name for the run.
- 3
Add your tasks. Write one task for each job you want done.
- 4
Give each task a role, like builder, scout, or reviewer. You can also pick a model per task and set which tasks wait on others.
- 5
Optional: turn on
Plan modeso agents only read and write plans — they never change files. - 6
Leave
Review before mergeon (the default) so each finished task waits for you to check it. - 7
Click Launch. The run board shows each task's status and a live event log.
- 8
When a task finishes, read its colored diff, then Approve and merge, or Reject.
Good to know
- Each task must pass a quality gate before it can merge. If your project has type checks or tests, HangarSwarm runs them and blocks a bad result.
- Isolated worktrees mean two agents never overwrite each other's files.
- Turn
Review before mergeoff only when you trust the run to merge on its own.