Skip to content

Worktrees

A Git worktree is an isolated checkout of your repository on a separate branch, so parallel work does not interfere with your active branch.

In Multi, worktree tasks run outside your main workspace so your current files stay untouched while the task operates.

In the task input footer, click the Local/Worktree toggle before submitting your prompt.

  • Enable Worktree before starting a task
  • Multi creates a task-specific worktree branch and runs changes there
  • Use this for risky refactors, large experiments, or parallel implementation work where rollback and review matter

Starting a new task in worktree mode

  • Keep your main workspace clean while the task runs
  • Compare results before integrating, which lowers merge risk
  • Work on multiple isolated branches in parallel without context switching
  • Merge worktree branch changes manually into your target branch so integration stays intentional
  • Deleting a worktree task removes its worktree checkout
  • Delete the Git branch manually after merge if you no longer need it

Deleting a worktree task and its checkout

From any message, click Fork with… and switch the mode button at the bottom of the menu to New Worktree for an isolated continuation path.

Forking a task into a new worktree