Skip to content

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

docs: clarify copy-ignored behavior and .worktreeinclude usage

Maximilian Roos5d3655b417df
diff --git a/.claude-plugin/skills/worktrunk/reference/tips-patterns.md b/.claude-plugin/skills/worktrunk/reference/tips-patterns.md
index ec7a53d3e..c91e979a8 100644
--- a/.claude-plugin/skills/worktrunk/reference/tips-patterns.md
+++ b/.claude-plugin/skills/worktrunk/reference/tips-patterns.md
@@ -14,7 +14,7 @@ wsc feature -- 'Fix GH #322' # Runs `claude 'Fix GH #322'`
## Eliminate cold starts
-Use [`wt step copy-ignored`](https://worktrunk.dev/step/#wt-step-copy-ignored) in a `post-create` hook to copy gitignored files listed in `.worktreeinclude` (caches, dependencies) between worktrees:
+Use [`wt step copy-ignored`](https://worktrunk.dev/step/#wt-step-copy-ignored) in a `post-create` hook to copy gitignored files (caches, dependencies, `.env`) between worktrees:
```toml
[post-create]
@@ -22,16 +22,16 @@ copy = "wt step copy-ignored"
install = "npm ci"
```
-`.worktreeinclude` uses gitignore syntax:
+All gitignored files are copied by default. To copy only specific patterns, create a `.worktreeinclude` file using gitignore syntax:
```gitignore
-# .worktreeinclude
-.cache/
+# .worktreeinclude — optional, limits what gets copied
+.env
node_modules/
target/
```
-See [`wt step copy-ignored`](https://worktrunk.dev/step/#wt-step-copy-ignored) for common patterns and language-specific notes.
+See [`wt step copy-ignored`](https://worktrunk.dev/step/#wt-step-copy-ignored) for details and language-specific notes.
## Dev server per worktree
diff --git a/docs/content/tips-patterns.md b/docs/content/tips-patterns.md
index 7c3474f51..988a47387 100644
--- a/docs/content/tips-patterns.md
+++ b/docs/content/tips-patterns.md
@@ -20,7 +20,7 @@ wsc feature -- 'Fix GH #322' # Runs `claude 'Fix GH #322'`
## Eliminate cold starts
-Use [`wt step copy-ignored`](@/step.md#wt-step-copy-ignored) in a `post-create` hook to copy gitignored files listed in `.worktreeinclude` (caches, dependencies) between worktrees:
+Use [`wt step copy-ignored`](@/step.md#wt-step-copy-ignored) in a `post-create` hook to copy gitignored files (caches, dependencies, `.env`) between worktrees:
```toml
[post-create]
@@ -28,16 +28,16 @@ copy = "wt step copy-ignored"
install = "npm ci"
```
-`.worktreeinclude` uses gitignore syntax:
+All gitignored files are copied by default. To copy only specific patterns, create a `.worktreeinclude` file using gitignore syntax:
```gitignore
-# .worktreeinclude
-.cache/
+# .worktreeinclude — optional, limits what gets copied
+.env
node_modules/
target/
```
-See [`wt step copy-ignored`](@/step.md#wt-step-copy-ignored) for common patterns and language-specific notes.
+See [`wt step copy-ignored`](@/step.md#wt-step-copy-ignored) for details and language-specific notes.
## Dev server per worktree