Skip to content

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

docs: add manual commit message recipes (#1469)

worktrunk-bot905aa273dfcb
diff --git a/docs/content/tips-patterns.md b/docs/content/tips-patterns.md
index 630d05f42..1d1f42f57 100644
--- a/docs/content/tips-patterns.md
+++ b/docs/content/tips-patterns.md
@@ -114,6 +114,28 @@ EOF
This catches issues locally before pushing — like running CI locally.
+## Manual commit messages
+
+The `commit.generation.command` receives the rendered prompt on stdin and returns the commit message on stdout. To write commit messages by hand instead of using an LLM, point it at `$EDITOR`:
+
+```toml
+# ~/.config/worktrunk/config.toml
+[commit.generation]
+command = '''f=$(mktemp); printf '\n\n' > "$f"; sed 's/^/# /' >> "$f"; ${EDITOR:-vi} "$f" < /dev/tty > /dev/tty; grep -v '^#' "$f"'''
+```
+
+This comments out the rendered prompt (diff, branch name, stats) with `#` prefixes, opens your editor, and strips comment lines on save. A couple of blank lines at the top give you space to type; the prompt context is visible below for reference.
+
+To keep the LLM as default but use the editor for a specific merge, add a [worktrunk alias](@/step.md#aliases):
+
+```toml
+# ~/.config/worktrunk/config.toml
+[aliases]
+mc = '''WORKTRUNK_COMMIT__GENERATION__COMMAND='f=$(mktemp); printf "\n\n" > "$f"; sed "s/^/# /" >> "$f"; ${EDITOR:-vi} "$f" < /dev/tty > /dev/tty; grep -v "^#" "$f"' wt merge'''
+```
+
+Then `wt step mc` opens an editor for the commit message while plain `wt merge` continues to use the LLM.
+
## Track agent status
Custom emoji markers show agent state in `wt list`. The Claude Code plugin sets these automatically:
diff --git a/skills/worktrunk/reference/tips-patterns.md b/skills/worktrunk/reference/tips-patterns.md
index 3ea0d2d87..f7849e572 100644
--- a/skills/worktrunk/reference/tips-patterns.md
+++ b/skills/worktrunk/reference/tips-patterns.md
@@ -103,6 +103,28 @@ EOF
This catches issues locally before pushing — like running CI locally.
+## Manual commit messages
+
+The `commit.generation.command` receives the rendered prompt on stdin and returns the commit message on stdout. To write commit messages by hand instead of using an LLM, point it at `$EDITOR`:
+
+```toml
+# ~/.config/worktrunk/config.toml
+[commit.generation]
+command = '''f=$(mktemp); printf '\n\n' > "$f"; sed 's/^/# /' >> "$f"; ${EDITOR:-vi} "$f" < /dev/tty > /dev/tty; grep -v '^#' "$f"'''
+```
+
+This comments out the rendered prompt (diff, branch name, stats) with `#` prefixes, opens your editor, and strips comment lines on save. A couple of blank lines at the top give you space to type; the prompt context is visible below for reference.
+
+To keep the LLM as default but use the editor for a specific merge, add a [worktrunk alias](https://worktrunk.dev/step/#aliases):
+
+```toml
+# ~/.config/worktrunk/config.toml
+[aliases]
+mc = '''WORKTRUNK_COMMIT__GENERATION__COMMAND='f=$(mktemp); printf "\n\n" > "$f"; sed "s/^/# /" >> "$f"; ${EDITOR:-vi} "$f" < /dev/tty > /dev/tty; grep -v "^#" "$f"' wt merge'''
+```
+
+Then `wt step mc` opens an editor for the commit message while plain `wt merge` continues to use the LLM.
+
## Track agent status
Custom emoji markers show agent state in `wt list`. The Claude Code plugin sets these automatically: