Skip to content

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

Regenerate help-md output

Maximilian Roos131a7bc7bc24
diff --git a/README.md b/README.md
index 9f333cd7e..27fb06d58 100644
--- a/README.md
+++ b/README.md
@@ -462,7 +462,7 @@ HEAD.
<!-- ⚠️ AUTO-GENERATED from `wt switch --help-md` — edit source to update -->
-```
+```text
wt switch — Switch to a worktree
Usage: wt switch [OPTIONS] <BRANCH>
@@ -562,37 +562,37 @@ See `wt config approvals --help`.
Switch to existing worktree:
-```bash
+```console
wt switch feature-branch
```
Create new worktree from main:
-```bash
+```console
wt switch --create new-feature
```
Switch to previous worktree:
-```bash
+```console
wt switch -
```
Create from specific base:
-```bash
+```console
wt switch --create hotfix --base production
```
Create and run command:
-```bash
+```console
wt switch --create docs --execute "code ."
```
Skip hooks during creation:
-```bash
+```console
wt switch --create temp --no-verify
```
@@ -600,7 +600,7 @@ wt switch --create temp --no-verify
Use `@` for current HEAD, `-` for previous, `^` for main:
-```bash
+```console
wt switch @ # Switch to current branch's worktree
wt switch - # Switch to previous worktree
wt switch --create new-feature --base=^ # Branch from main (default)
@@ -617,7 +617,7 @@ wt remove @ # Remove current worktree
<!-- ⚠️ AUTO-GENERATED from `wt merge --help-md` — edit source to update -->
-```
+```text
wt merge — Merge worktree into target branch
Usage: wt merge [OPTIONS] [TARGET]
@@ -707,25 +707,25 @@ See `wt config approvals --help`.
Basic merge to main:
-```bash
+```console
wt merge
```
Merge without squashing:
-```bash
+```console
wt merge --no-squash
```
Keep worktree after merging:
-```bash
+```console
wt merge --no-remove
```
Skip all hooks:
-```bash
+```console
wt merge --no-verify
```
@@ -738,7 +738,7 @@ wt merge --no-verify
<!-- ⚠️ AUTO-GENERATED from `wt remove --help-md` — edit source to update -->
-```
+```text
wt remove — Remove worktree and branch
Usage: wt remove [OPTIONS] [WORKTREES]...
@@ -834,37 +834,37 @@ Stops any git fsmonitor daemon for the worktree before removal. This prevents or
Remove current worktree and branch:
-```bash
+```console
wt remove
```
Remove specific worktree and branch:
-```bash
+```console
wt remove feature-branch
```
Remove worktree but keep branch:
-```bash
+```console
wt remove --no-delete-branch feature-branch
```
Remove multiple worktrees:
-```bash
+```console
wt remove old-feature another-branch
```
Remove in foreground (blocking):
-```bash
+```console
wt remove --no-background feature-branch
```
Switch to default in main:
-```bash
+```console
wt remove # (when already in main worktree)
```
@@ -877,7 +877,7 @@ wt remove # (when already in main worktree)
<!-- ⚠️ AUTO-GENERATED from `wt list --help-md` — edit source to update -->
-```
+```text
wt list — List worktrees and optionally branches
Usage: wt list [OPTIONS]
wt list <COMMAND>
@@ -992,7 +992,7 @@ Note: `locked` and `prunable` are top-level fields on worktree objects, not in s
**Query examples:**
-```bash
+```console
# Find worktrees with conflicts
jq '.[] | select(.status.branch_state == "Conflicts")'
@@ -1021,7 +1021,7 @@ jq '.[] | select(.is_current == true)'
<!-- ⚠️ AUTO-GENERATED from `wt config --help-md` — edit source to update -->
-```
+```text
wt config — Manage configuration and shell integration
Usage: wt config [OPTIONS] <COMMAND>
@@ -1053,19 +1053,19 @@ Global Options:
1. Set up shell integration
- ```bash
+ ```console
wt config shell install
```
Or manually add to the shell config:
- ```bash
+ ```console
eval "$(wt config shell init bash)"
```
2. (Optional) Create user config file
- ```bash
+ ```console
wt config create
```
@@ -1086,7 +1086,7 @@ Global Options:
For Claude:
-```bash
+```console
llm install llm-anthropic
llm keys set anthropic
llm models default claude-haiku-4-5-20251001
@@ -1094,7 +1094,7 @@ llm models default claude-haiku-4-5-20251001
For OpenAI:
-```bash
+```console
llm keys set openai
```
@@ -1122,7 +1122,7 @@ Docs: <https://llm.datasette.io/> | <https://github.com/sigoden/aichat>
<!-- ⚠️ AUTO-GENERATED from `wt step --help-md` — edit source to update -->
-```
+```text
wt step — Workflow building blocks
Usage: wt step [OPTIONS] <COMMAND>
diff --git a/docs/content/commands.md b/docs/content/commands.md
index 140c82f19..8e6dabb11 100644
--- a/docs/content/commands.md
+++ b/docs/content/commands.md
@@ -7,7 +7,7 @@ weight = 5
<!-- ⚠️ AUTO-GENERATED from `wt switch --help-md` — edit source to update -->
-```
+```text
wt switch — Switch to a worktree
Usage: wt switch [OPTIONS] <BRANCH>
@@ -107,37 +107,37 @@ See `wt config approvals --help`.
Switch to existing worktree:
-```bash
+```console
wt switch feature-branch
```
Create new worktree from main:
-```bash
+```console
wt switch --create new-feature
```
Switch to previous worktree:
-```bash
+```console
wt switch -
```
Create from specific base:
-```bash
+```console
wt switch --create hotfix --base production
```
Create and run command:
-```bash
+```console
wt switch --create docs --execute "code ."
```
Skip hooks during creation:
-```bash
+```console
wt switch --create temp --no-verify
```
@@ -145,7 +145,7 @@ wt switch --create temp --no-verify
Use `@` for current HEAD, `-` for previous, `^` for main:
-```bash
+```console
wt switch @ # Switch to current branch's worktree
wt switch - # Switch to previous worktree
wt switch --create new-feature --base=^ # Branch from main (default)
@@ -161,7 +161,7 @@ wt remove @ # Remove current worktree
<!-- ⚠️ AUTO-GENERATED from `wt merge --help-md` — edit source to update -->
-```
+```text
wt merge — Merge worktree into target branch
Usage: wt merge [OPTIONS] [TARGET]
@@ -251,25 +251,25 @@ See `wt config approvals --help`.
Basic merge to main:
-```bash
+```console
wt merge
```
Merge without squashing:
-```bash
+```console
wt merge --no-squash
```
Keep worktree after merging:
-```bash
+```console
wt merge --no-remove
```
Skip all hooks:
-```bash
+```console
wt merge --no-verify
```
@@ -281,7 +281,7 @@ wt merge --no-verify
<!-- ⚠️ AUTO-GENERATED from `wt remove --help-md` — edit source to update -->
-```
+```text
wt remove — Remove worktree and branch
Usage: wt remove [OPTIONS] [WORKTREES]...
@@ -377,37 +377,37 @@ Stops any git fsmonitor daemon for the worktree before removal. This prevents or
Remove current worktree and branch:
-```bash
+```console
wt remove
```
Remove specific worktree and branch:
-```bash
+```console
wt remove feature-branch
```
Remove worktree but keep branch:
-```bash
+```console
wt remove --no-delete-branch feature-branch
```
Remove multiple worktrees:
-```bash
+```console
wt remove old-feature another-branch
```
Remove in foreground (blocking):
-```bash
+```console
wt remove --no-background feature-branch
```
Switch to default in main:
-```bash
+```console
wt remove # (when already in main worktree)
```
@@ -419,7 +419,7 @@ wt remove # (when already in main worktree)
<!-- ⚠️ AUTO-GENERATED from `wt list --help-md` — edit source to update -->
-```
+```text
wt list — List worktrees and optionally branches
Usage: wt list [OPTIONS]
wt list <COMMAND>
@@ -534,7 +534,7 @@ Note: `locked` and `prunable` are top-level fields on worktree objects, not in s
**Query examples:**
-```bash
+```console
# Find worktrees with conflicts
jq '.[] | select(.status.branch_state == "Conflicts")'
@@ -562,7 +562,7 @@ jq '.[] | select(.is_current == true)'
<!-- ⚠️ AUTO-GENERATED from `wt config --help-md` — edit source to update -->
-```
+```text
wt config — Manage configuration and shell integration
Usage: wt config [OPTIONS] <COMMAND>
@@ -594,19 +594,19 @@ Global Options:
1. Set up shell integration
- ```bash
+ ```console
wt config shell install
```
Or manually add to the shell config:
- ```bash
+ ```console
eval "$(wt config shell init bash)"
```
2. (Optional) Create user config file
- ```bash
+ ```console
wt config create
```
@@ -627,7 +627,7 @@ Global Options:
For Claude:
-```bash
+```console
llm install llm-anthropic
llm keys set anthropic
llm models default claude-haiku-4-5-20251001
@@ -635,7 +635,7 @@ llm models default claude-haiku-4-5-20251001
For OpenAI:
-```bash
+```console
llm keys set openai
```
@@ -662,7 +662,7 @@ Docs: <https://llm.datasette.io/> | <https://github.com/sigoden/aichat>
<!-- ⚠️ AUTO-GENERATED from `wt step --help-md` — edit source to update -->
-```
+```text
wt step — Workflow building blocks
Usage: wt step [OPTIONS] <COMMAND>