Skip to content

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

Reorganize copy-ignored documentation structure

Maximilian Roos00819d2e34cb
diff --git a/.claude-plugin/skills/worktrunk/reference/step.md b/.claude-plugin/skills/worktrunk/reference/step.md
index dc1b0e12f..577774b2b 100644
--- a/.claude-plugin/skills/worktrunk/reference/step.md
+++ b/.claude-plugin/skills/worktrunk/reference/step.md
@@ -238,20 +238,19 @@ Add to the project config:
copy = "wt step copy-ignored"
```
-All gitignored files are copied by default, as if `.worktreeinclude` contained `**`. To copy only specific patterns, create a `.worktreeinclude` file using gitignore syntax:
+### What gets copied
+
+All gitignored files are copied by default. Tracked files are never touched.
+
+To limit what gets copied, create `.worktreeinclude` with gitignore-style patterns. Files must be **both** gitignored **and** in `.worktreeinclude`:
```gitignore
-# .worktreeinclude — optional, limits what gets copied
+# .worktreeinclude
.env
node_modules/
target/
-.cache/
```
-### What gets copied
-
-Only gitignored files are copied — tracked files are never touched. If `.worktreeinclude` exists, files must match **both** `.worktreeinclude` **and** be gitignored.
-
### Common patterns
| Type | Patterns |
diff --git a/.claude-plugin/skills/worktrunk/reference/tips-patterns.md b/.claude-plugin/skills/worktrunk/reference/tips-patterns.md
index 1882cbb37..0b04d2a3c 100644
--- a/.claude-plugin/skills/worktrunk/reference/tips-patterns.md
+++ b/.claude-plugin/skills/worktrunk/reference/tips-patterns.md
@@ -22,16 +22,7 @@ copy = "wt step copy-ignored"
install = "npm ci"
```
-All gitignored files are copied by default. To copy only specific patterns, create a `.worktreeinclude` file using gitignore syntax:
-
-```gitignore
-# .worktreeinclude — optional, limits what gets copied
-.env
-node_modules/
-target/
-```
-
-See [`wt step copy-ignored`](https://worktrunk.dev/step/#wt-step-copy-ignored) for details and language-specific notes.
+All gitignored files are copied by default. To limit what gets copied, create `.worktreeinclude` with patterns — files must be both gitignored and listed. See [`wt step copy-ignored`](https://worktrunk.dev/step/#wt-step-copy-ignored) for details.
## Dev server per worktree
diff --git a/docs/content/step.md b/docs/content/step.md
index a50d8d535..bf0409327 100644
--- a/docs/content/step.md
+++ b/docs/content/step.md
@@ -257,20 +257,19 @@ Add to the project config:
copy = "wt step copy-ignored"
```
-All gitignored files are copied by default, as if `.worktreeinclude` contained `**`. To copy only specific patterns, create a `.worktreeinclude` file using gitignore syntax:
+### What gets copied
+
+All gitignored files are copied by default. Tracked files are never touched.
+
+To limit what gets copied, create `.worktreeinclude` with gitignore-style patterns. Files must be **both** gitignored **and** in `.worktreeinclude`:
```gitignore
-# .worktreeinclude — optional, limits what gets copied
+# .worktreeinclude
.env
node_modules/
target/
-.cache/
```
-### What gets copied
-
-Only gitignored files are copied — tracked files are never touched. If `.worktreeinclude` exists, files must match **both** `.worktreeinclude` **and** be gitignored.
-
### Common patterns
| Type | Patterns |
diff --git a/docs/content/tips-patterns.md b/docs/content/tips-patterns.md
index e6b54ba2f..3970ccc41 100644
--- a/docs/content/tips-patterns.md
+++ b/docs/content/tips-patterns.md
@@ -28,16 +28,7 @@ copy = "wt step copy-ignored"
install = "npm ci"
```
-All gitignored files are copied by default. To copy only specific patterns, create a `.worktreeinclude` file using gitignore syntax:
-
-```gitignore
-# .worktreeinclude — optional, limits what gets copied
-.env
-node_modules/
-target/
-```
-
-See [`wt step copy-ignored`](@/step.md#wt-step-copy-ignored) for details and language-specific notes.
+All gitignored files are copied by default. To limit what gets copied, create `.worktreeinclude` with patterns — files must be both gitignored and listed. See [`wt step copy-ignored`](@/step.md#wt-step-copy-ignored) for details.
## Dev server per worktree
diff --git a/src/cli/step.rs b/src/cli/step.rs
index 8fae01644..ca72c1482 100644
--- a/src/cli/step.rs
+++ b/src/cli/step.rs
@@ -170,20 +170,19 @@ Add to the project config:
copy = "wt step copy-ignored"
```
-All gitignored files are copied by default, as if `.worktreeinclude` contained `**`. To copy only specific patterns, create a `.worktreeinclude` file using gitignore syntax:
+## What gets copied
+
+All gitignored files are copied by default. Tracked files are never touched.
+
+To limit what gets copied, create `.worktreeinclude` with gitignore-style patterns. Files must be **both** gitignored **and** in `.worktreeinclude`:
```gitignore
-# .worktreeinclude — optional, limits what gets copied
+# .worktreeinclude
.env
node_modules/
target/
-.cache/
```
-## What gets copied
-
-Only gitignored files are copied — tracked files are never touched. If `.worktreeinclude` exists, files must match **both** `.worktreeinclude` **and** be gitignored.
-
## Common patterns
| Type | Patterns |