Skip to content

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

docs(switch): say that wt list flags a --path worktree off its template path (#4328)

Worktrunk Bot2f859400127e
diff --git a/docs/src/content/docs/switch.md b/docs/src/content/docs/switch.md
index 4af8419dd..33a115e64 100644
--- a/docs/src/content/docs/switch.md
+++ b/docs/src/content/docs/switch.md
@@ -64,7 +64,7 @@ $ wt switch ../dark-mode # Switch by path...
$ wt switch feature/JIRA-1234 # ...or by branch
```
-Worktrunk finds the worktree from git's own records, so only [`wt step relocate`](/step/#wt-step-relocate) treats it differently: it offers to move the worktree back to the template path.
+Worktrunk finds the worktree from git's own records, so commands reach it by branch or path as usual. [`wt list`](/list/#worktree) marks it `⚑`, since it isn't at the path its branch implies, and [`wt step relocate`](/step/#wt-step-relocate) offers to move it back to the template path.
## Naming a worktree
diff --git a/plugins/worktrunk/skills/worktrunk/reference/switch.md b/plugins/worktrunk/skills/worktrunk/reference/switch.md
index 305193c78..06ab1815c 100644
--- a/plugins/worktrunk/skills/worktrunk/reference/switch.md
+++ b/plugins/worktrunk/skills/worktrunk/reference/switch.md
@@ -48,7 +48,7 @@ $ wt switch ../dark-mode # Switch by path...
$ wt switch feature/JIRA-1234 # ...or by branch
```
-Worktrunk finds the worktree from git's own records, so only [`wt step relocate`](https://worktrunk.dev/step/#wt-step-relocate) treats it differently: it offers to move the worktree back to the template path.
+Worktrunk finds the worktree from git's own records, so commands reach it by branch or path as usual. [`wt list`](https://worktrunk.dev/list/#worktree) marks it `⚑`, since it isn't at the path its branch implies, and [`wt step relocate`](https://worktrunk.dev/step/#wt-step-relocate) offers to move it back to the template path.
## Naming a worktree
diff --git a/skills/worktrunk/reference/switch.md b/skills/worktrunk/reference/switch.md
index 305193c78..06ab1815c 100644
--- a/skills/worktrunk/reference/switch.md
+++ b/skills/worktrunk/reference/switch.md
@@ -48,7 +48,7 @@ $ wt switch ../dark-mode # Switch by path...
$ wt switch feature/JIRA-1234 # ...or by branch
```
-Worktrunk finds the worktree from git's own records, so only [`wt step relocate`](https://worktrunk.dev/step/#wt-step-relocate) treats it differently: it offers to move the worktree back to the template path.
+Worktrunk finds the worktree from git's own records, so commands reach it by branch or path as usual. [`wt list`](https://worktrunk.dev/list/#worktree) marks it `⚑`, since it isn't at the path its branch implies, and [`wt step relocate`](https://worktrunk.dev/step/#wt-step-relocate) offers to move it back to the template path.
## Naming a worktree
diff --git a/src/cli/mod.rs b/src/cli/mod.rs
index 01d60e3dc..14c0d70c7 100644
--- a/src/cli/mod.rs
+++ b/src/cli/mod.rs
@@ -684,7 +684,7 @@ $ wt switch ../dark-mode # Switch by path...
$ wt switch feature/JIRA-1234 # ...or by branch
```
-Worktrunk finds the worktree from git's own records, so only [`wt step relocate`](/step/#wt-step-relocate) treats it differently: it offers to move the worktree back to the template path.
+Worktrunk finds the worktree from git's own records, so commands reach it by branch or path as usual. [`wt list`](/list/#worktree) marks it `⚑`, since it isn't at the path its branch implies, and [`wt step relocate`](/step/#wt-step-relocate) offers to move it back to the template path.
## Naming a worktree
diff --git a/tests/snapshots/integration__integration_tests__help__help_switch_long.snap b/tests/snapshots/integration__integration_tests__help__help_switch_long.snap
index a20507c92..527f67176 100644
--- a/tests/snapshots/integration__integration_tests__help__help_switch_long.snap
+++ b/tests/snapshots/integration__integration_tests__help__help_switch_long.snap
@@ -184,7 +184,7 @@ If the branch already has a worktree, wt switch changes directories to i
  wt switch ../dark-mode # Switch by path...
  wt switch feature/JIRA-1234 # ...or by branch
-Worktrunk finds the worktree from git's own records, so only wt step relocate treats it differently: it offers to move the worktree back to the template path.
+Worktrunk finds the worktree from git's own records, so commands reach it by branch or path as usual. wt list marks it ⚑, since it isn't at the path its branch implies, and wt step relocate offers to move it back to the template path.
Naming a worktree