Worktrunk is a CLI for Git worktree management, designed for parallel AI agent workflows
Refactor: clarify hook documentation and flag descriptions
Maximilian Roos7b512bd71e7c
diff --git a/.claude-plugin/skills/worktrunk/reference/hook.md b/.claude-plugin/skills/worktrunk/reference/hook.mdindex 11130a580..d2d55da90 100644--- a/.claude-plugin/skills/worktrunk/reference/hook.md+++ b/.claude-plugin/skills/worktrunk/reference/hook.md@@ -196,7 +196,7 @@ Both run when creating a worktree. The difference:| Hook | Execution | Best for ||------|-----------|----------|| `post-create` | Blocks until complete | Tasks the developer needs before working (dependency install) |-| `post-start` | Background, parallel | Long-running tasks that can finish in parallel |+| `post-start` | Background, parallel | Long-running tasks that don't block worktree creation |Many tasks work well in `post-start` — they'll likely be ready by the time they're needed, especially when the fallback is recompiling. If unsure, prefer `post-start` for faster worktree creation.@@ -377,7 +377,7 @@ wt hook post-create --var branch=feature/test # Override template variableThe `user:` and `project:` prefixes filter by source. Use `user:` or `project:` alone to run all hooks from that source, or `user:name` / `project:name` to run a specific hook.-The `--var KEY=VALUE` flag lets you override built-in template variables — useful for testing hooks with different contexts without switching to that context.+The `--var KEY=VALUE` flag overrides built-in template variables — useful for testing hooks with different contexts without switching to that context.## Language-specific tipsdiff --git a/docs/content/hook.md b/docs/content/hook.mdindex dd70da8c1..e82b06b8d 100644--- a/docs/content/hook.md+++ b/docs/content/hook.md@@ -204,7 +204,7 @@ Both run when creating a worktree. The difference:| Hook | Execution | Best for ||------|-----------|----------|| `post-create` | Blocks until complete | Tasks the developer needs before working (dependency install) |-| `post-start` | Background, parallel | Long-running tasks that can finish in parallel |+| `post-start` | Background, parallel | Long-running tasks that don't block worktree creation |Many tasks work well in `post-start` — they'll likely be ready by the time they're needed, especially when the fallback is recompiling. If unsure, prefer `post-start` for faster worktree creation.@@ -385,7 +385,7 @@ wt hook post-create --var branch=feature/test # Override template variableThe `user:` and `project:` prefixes filter by source. Use `user:` or `project:` alone to run all hooks from that source, or `user:name` / `project:name` to run a specific hook.-The `--var KEY=VALUE` flag lets you override built-in template variables — useful for testing hooks with different contexts without switching to that context.+The `--var KEY=VALUE` flag overrides built-in template variables — useful for testing hooks with different contexts without switching to that context.## Language-specific tipsdiff --git a/src/cli/mod.rs b/src/cli/mod.rsindex f260d7345..7d1086c73 100644--- a/src/cli/mod.rs+++ b/src/cli/mod.rs@@ -1186,7 +1186,7 @@ Both run when creating a worktree. The difference:| Hook | Execution | Best for ||------|-----------|----------|| `post-create` | Blocks until complete | Tasks the developer needs before working (dependency install) |-| `post-start` | Background, parallel | Long-running tasks that can finish in parallel |+| `post-start` | Background, parallel | Long-running tasks that don't block worktree creation |Many tasks work well in `post-start` — they'll likely be ready by the time they're needed, especially when the fallback is recompiling. If unsure, prefer `post-start` for faster worktree creation.@@ -1367,7 +1367,7 @@ wt hook post-create --var branch=feature/test # Override template variableThe `user:` and `project:` prefixes filter by source. Use `user:` or `project:` alone to run all hooks from that source, or `user:name` / `project:name` to run a specific hook.-The `--var KEY=VALUE` flag lets you override built-in template variables — useful for testing hooks with different contexts without switching to that context.+The `--var KEY=VALUE` flag overrides built-in template variables — useful for testing hooks with different contexts without switching to that context.## Language-specific tips