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.
Start a Task in Worktree Mode
Section titled “Start a Task in Worktree Mode”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
Why Use Worktrees
Section titled “Why Use Worktrees”- 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 and Cleanup
Section titled “Merge and Cleanup”- 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
Forking With Worktrees
Section titled “Forking With Worktrees”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