Isolate Work in a Worktree

Running an agent on your main checkout means any misstep touches your current work. Give it a worktree instead: its own branch and directory, your checkout untouched.

1. Create a worktree

Choose File › New Worktree… from the menu, or open the command palette (⌘K → New Worktree…). Verne creates the worktree in a managed location, checks out a new branch, and opens a terminal tab rooted there.

The worktree appears under its parent repository in the Workspaces panel. For background on how worktrees work, see Workspaces & Worktrees.

2. Launch your agent

In the worktree’s terminal, start your agent:

$ claude

Give it the task. The agent reads and writes files inside the worktree directory only. Your main checkout is untouched.

3. Review the changes

When the agent finishes, open Source Control for the worktree. Review the diff for each changed file. If anything looks wrong, add comments and use Code Review to send feedback back to the agent.

4. Merge or discard

If the result is good, commit in Source Control and merge the branch into your main branch.

To discard everything, right-click the worktree in the Workspaces panel and remove it. Verne detaches it, deletes its directory, and leaves your main checkout untouched.

Next steps

• Workspaces & Worktrees: the full model for creating and managing worktrees.
• Multi-Agent Workflows: run several agents at once, each in its own worktree.
• Code Review: send agent changes back for revision.