Using it

Parallel mode

Let agents work at the same time, each on its own branch.

Shared folder or Parallel

The Mode button in the session header has two settings:

• Shared folder (default): agents work in your folder and take turns.
• Parallel: each agent works in its own copy of the project, a git worktree on its own branch. Agents you mention together work at the same time.

Worktrees are kept in ~/.agentscircle/worktrees.

Branches tab

In parallel mode the session panel gets a Branches tab, with one branch per agent:

• Compare: see how the branches differ.
• Review: read a branch's changes.
• Apply to my folder: bring a branch into your folder with a three-way merge. Where changes clash, the file gets clash markers for you to resolve.
• Discard: throw a branch away.
• Ask an agent to combine them: have an agent merge the best of several branches.