Worktree Management

Multi-agent workspace isolation — each agent gets its own working directory with file-level locking

Create Worktree
Spawn an isolated workspace for a new agent
Isolation Levels
How agents coexist within the same project
Full

Complete isolation. Each agent has its own copy of all files. No shared state. Best for conflicting changes.

Shared Read

Agents can read shared files but write to their own branch. Good for agents working on different features.

Optimistic

Agents share the workspace with file-level locking. Fastest but requires conflict resolution. Default mode.

Active Worktrees
Currently active agent workspaces with file locks and status

No active worktrees

Create a worktree to start multi-agent collaboration

Merge Strategies
Fast Forward

Simple linear merge when no divergence exists. Fastest but requires clean history.

Three-Way MergeDefault

Standard merge using common ancestor. Handles most conflicts automatically.

Last Writer Wins

Always accept the latest change. No conflicts but may lose earlier work. Use with caution.