Skip to content

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

docs: clarify project vs user hook configuration locations

Maximilian Roosf92e2bb60f9d
diff --git a/.claude-plugin/skills/worktrunk/reference/hook.md b/.claude-plugin/skills/worktrunk/reference/hook.md
index 88edce442..158b33f33 100644
--- a/.claude-plugin/skills/worktrunk/reference/hook.md
+++ b/.claude-plugin/skills/worktrunk/reference/hook.md
@@ -109,7 +109,11 @@ Manage approvals with `wt hook approvals add` and `wt hook approvals clear`.
## Configuration
-Hooks are defined in `.config/wt.toml`. They can be a single command or multiple named commands:
+Hooks can be defined in two places: project config (`.config/wt.toml`) for repository-specific automation, or user config (`~/.config/worktrunk/config.toml`) for personal automation across all repositories.
+
+### Project hooks
+
+Project hooks are defined in `.config/wt.toml`. They can be a single command or multiple named commands:
```toml
# Single command (string)
diff --git a/docs/content/hook.md b/docs/content/hook.md
index 72c194f3e..cbdfc2244 100644
--- a/docs/content/hook.md
+++ b/docs/content/hook.md
@@ -117,7 +117,11 @@ Manage approvals with `wt hook approvals add` and `wt hook approvals clear`.
## Configuration
-Hooks are defined in `.config/wt.toml`. They can be a single command or multiple named commands:
+Hooks can be defined in two places: project config (`.config/wt.toml`) for repository-specific automation, or user config (`~/.config/worktrunk/config.toml`) for personal automation across all repositories.
+
+### Project hooks
+
+Project hooks are defined in `.config/wt.toml`. They can be a single command or multiple named commands:
```toml
# Single command (string)
diff --git a/src/cli/mod.rs b/src/cli/mod.rs
index 252c1e1bc..77101ecd0 100644
--- a/src/cli/mod.rs
+++ b/src/cli/mod.rs
@@ -1105,7 +1105,11 @@ Manage approvals with `wt hook approvals add` and `wt hook approvals clear`.
## Configuration
-Hooks are defined in `.config/wt.toml`. They can be a single command or multiple named commands:
+Hooks can be defined in two places: project config (`.config/wt.toml`) for repository-specific automation, or user config (`~/.config/worktrunk/config.toml`) for personal automation across all repositories.
+
+### Project hooks
+
+Project hooks are defined in `.config/wt.toml`. They can be a single command or multiple named commands:
```toml
# Single command (string)