Skip to content

Worktrunk is a CLI for Git worktree management, designed for parallel AI agent workflows

docs(relocate): document main worktree behavior (#889)

Maximilian Roosaf676c72e001
diff --git a/src/cli/step.rs b/src/cli/step.rs
index af2af513a..d9843376c 100644
--- a/src/cli/step.rs
+++ b/src/cli/step.rs
@@ -363,6 +363,12 @@ this by using a temporary location.
With `--clobber`, non-worktree paths at target locations are moved to
`<path>.bak-<timestamp>` before relocating.
+## Main worktree behavior
+
+The main worktree can't be moved with `git worktree move`. Instead, relocate
+switches it to the default branch and creates a new linked worktree at the
+expected path. Untracked and gitignored files remain at the original location.
+
## Skipped worktrees
- **Dirty** (without `--commit`) — use `--commit` to auto-commit first