Skip to content

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

docs: add performance benchmarks to copy-ignored documentation (#560)

Maximilian Roos29938c683f87
diff --git a/.claude-plugin/skills/worktrunk/reference/step.md b/.claude-plugin/skills/worktrunk/reference/step.md
index ea6adf995..af83502b3 100644
--- a/.claude-plugin/skills/worktrunk/reference/step.md
+++ b/.claude-plugin/skills/worktrunk/reference/step.md
@@ -137,6 +137,16 @@ Only gitignored files are copied — tracked files are never touched. If `.workt
- Skips existing files (safe to re-run)
- Skips symlinks and `.git` entries
+### Performance
+
+Reflink copies share disk blocks until modified — no data is actually copied. For a 31GB `target/` directory with 110k files:
+
+| Method | Time |
+|--------|------|
+| Full copy (`cp -R`) | 2m 5s |
+| COW copy (`cp -Rc`) | ~60s |
+| `wt step copy-ignored` | ~31s |
+
### Language-specific notes
#### Rust
diff --git a/docs/content/step.md b/docs/content/step.md
index 7f1b35930..264d148a0 100644
--- a/docs/content/step.md
+++ b/docs/content/step.md
@@ -152,6 +152,16 @@ Only gitignored files are copied — tracked files are never touched. If `.workt
- Skips existing files (safe to re-run)
- Skips symlinks and `.git` entries
+### Performance
+
+Reflink copies share disk blocks until modified — no data is actually copied. For a 31GB `target/` directory with 110k files:
+
+| Method | Time |
+|--------|------|
+| Full copy (`cp -R`) | 2m 5s |
+| COW copy (`cp -Rc`) | ~60s |
+| `wt step copy-ignored` | ~31s |
+
### Language-specific notes
#### Rust
diff --git a/src/cli/step.rs b/src/cli/step.rs
index 5ca9b7c85..0444397a1 100644
--- a/src/cli/step.rs
+++ b/src/cli/step.rs
@@ -126,6 +126,16 @@ Only gitignored files are copied — tracked files are never touched. If `.workt
- Skips existing files (safe to re-run)
- Skips symlinks and `.git` entries
+## Performance
+
+Reflink copies share disk blocks until modified — no data is actually copied. For a 31GB `target/` directory with 110k files:
+
+| Method | Time |
+|--------|------|
+| Full copy (`cp -R`) | 2m 5s |
+| COW copy (`cp -Rc`) | ~60s |
+| `wt step copy-ignored` | ~31s |
+
## Language-specific notes
### Rust