Skip to content

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

Document post-start hook for large asset downloads

Maximilian Roos31b2eb247344
diff --git a/dev/wt.example.toml b/dev/wt.example.toml
index fb9fee869..cd14cc6a4 100644
--- a/dev/wt.example.toml
+++ b/dev/wt.example.toml
@@ -31,7 +31,7 @@
# Post-Start Hook
# Runs in BACKGROUND as detached processes (parallel)
# Use for: uv sync, npm install, bundle install, build, dev servers, file watchers,
-# long-running tasks
+# downloading assets too large for git (images, ML models, binaries), long-running tasks
# The worktree switch completes immediately, these run in parallel
# Output is logged to .git/wt-logs/{branch}-post-start-{name}.log
#
diff --git a/docs/content/hooks.md b/docs/content/hooks.md
index 6668a9e33..e23311a1a 100644
--- a/docs/content/hooks.md
+++ b/docs/content/hooks.md
@@ -113,12 +113,13 @@ env = "cp .env.example .env"
Runs after worktree creation, **in background**. The worktree switch completes immediately; these run in parallel.
-**Use cases**: Long builds, dev servers, file watchers — anything slow that doesn't need to block.
+**Use cases**: Long builds, dev servers, file watchers, downloading assets too large for git — anything slow that doesn't need to block.
```toml
[post-start]
build = "npm run build"
server = "npm run dev"
+assets = "./scripts/fetch-large-assets"
```
**Behavior**: