Skip to content

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

Sync README from main

Maximilian Roos0d1117c7e168
diff --git a/README.md b/README.md
index 16ec17e2c..d805b0f41 100644
--- a/README.md
+++ b/README.md
@@ -535,18 +535,6 @@ wt switch ^ # Main worktree
wt switch --create fix --base=@ # Branch from current HEAD
```
-### Path-First Lookup
-
-Arguments resolve by checking the filesystem before git branches:
-
-1. Compute expected path from argument (using configured path template)
-2. If worktree exists at that path, switch to it
-3. Otherwise, treat argument as branch name
-
-**Edge case**: If `repo.foo/` exists but tracks branch `bar`:
-- `wt switch foo` → switches to `repo.foo/` (the `bar` worktree)
-- `wt switch bar` → also works (branch lookup finds same worktree)
-
### Creating Worktrees
With `--create`, worktrunk:
@@ -564,6 +552,18 @@ wt switch --create docs --execute "code ."
wt switch --create temp --no-verify # Skip hooks
```
+### Path-First Lookup
+
+Arguments resolve by checking the filesystem before git branches:
+
+1. Compute expected path from argument (using configured path template)
+2. If worktree exists at that path, switch to it
+3. Otherwise, treat argument as branch name
+
+**Edge case**: If `repo.foo/` exists but tracks branch `bar`:
+- `wt switch foo` → switches to `repo.foo/` (the `bar` worktree)
+- `wt switch bar` → also works (branch lookup finds same worktree)
+
### See Also
- [wt select](/select/) — Interactive worktree selection