Skip to content

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

Format help text command references with backticks

Maximilian Roos92abd99656c3
diff --git a/README.md b/README.md
index 07f33b843..9fe57ff9c 100644
--- a/README.md
+++ b/README.md
@@ -113,7 +113,7 @@ cargo install worktrunk && wt config shell install
## Next steps
-- Learn the core commands: [wt switch](https://worktrunk.dev/switch/), [wt list](https://worktrunk.dev/list/), [wt merge](https://worktrunk.dev/merge/), [wt remove](https://worktrunk.dev/remove/)
+- Learn the core commands: [`wt switch`](https://worktrunk.dev/switch/), [`wt list`](https://worktrunk.dev/list/), [`wt merge`](https://worktrunk.dev/merge/), [`wt remove`](https://worktrunk.dev/remove/)
- Set up [project hooks](https://worktrunk.dev/hook/) for automated setup
- Explore [LLM commit messages](https://worktrunk.dev/llm-commits/), [fzf-like
selector](https://worktrunk.dev/select/), [Claude Code integration](https://worktrunk.dev/claude-code/), [CI
diff --git a/docs/content/config.md b/docs/content/config.md
index 0ed42d2f4..ef7458b95 100644
--- a/docs/content/config.md
+++ b/docs/content/config.md
@@ -146,7 +146,7 @@ notify = "notify-send 'Merging {{ branch }}'"
User hooks run before project hooks and don't require approval. Skip with `--no-verify`.
-See [wt hook](@/hook.md#user-hooks) for complete documentation.
+See [`wt hook`](@/hook.md#user-hooks) for complete documentation.
## Project config
@@ -163,7 +163,7 @@ test = "npm test"
lint = "npm run lint"
```
-See [wt hook](@/hook.md) for complete documentation on hook types, execution order, template variables, and [JSON context](@/hook.md#json-context).
+See [`wt hook`](@/hook.md) for complete documentation on hook types, execution order, template variables, and [JSON context](@/hook.md#json-context).
### Dev server URL
@@ -787,7 +787,7 @@ Usage: <b><span class=c>wt config state default-branch</span></b> <span class=c>
## wt config state ci-status
-Caches GitHub/GitLab CI status for display in [wt list](@/list.md#ci-status).
+Caches GitHub/GitLab CI status for display in [`wt list`](@/list.md#ci-status).
### How it works
@@ -807,7 +807,7 @@ Caches GitHub/GitLab CI status for display in [wt list](@/list.md#ci-status).
| `no-ci` | No checks configured |
| `error` | Fetch error (rate limit, network, auth) |
-See [wt list CI status](@/list.md#ci-status) for display symbols and colors.
+See [`wt list` CI status](@/list.md#ci-status) for display symbols and colors.
### When to use
diff --git a/docs/content/hook.md b/docs/content/hook.md
index 74a553e2b..d27cdbf7a 100644
--- a/docs/content/hook.md
+++ b/docs/content/hook.md
@@ -118,7 +118,7 @@ cleanup = "rm -rf /tmp/cache/{{ branch }}"
- **pre-remove** — Before removing worktree during cleanup
- **post-merge** — After cleanup completes
-See [wt merge](@/merge.md#pipeline) for the complete pipeline.
+See [`wt merge`](@/merge.md#pipeline) for the complete pipeline.
## Configuration
@@ -470,9 +470,9 @@ fi
## See also
-- [wt merge](@/merge.md) — Runs hooks automatically during merge
-- [wt switch](@/switch.md) — Runs post-create/post-start hooks on `--create`
-- [wt config](@/config.md) — Manage hook approvals
+- [`wt merge`](@/merge.md) — Runs hooks automatically during merge
+- [`wt switch`](@/switch.md) — Runs post-create/post-start hooks on `--create`
+- [`wt config`](@/config.md) — Manage hook approvals
## Command reference
diff --git a/docs/content/list.md b/docs/content/list.md
index 2c04d3097..bf959f43a 100644
--- a/docs/content/list.md
+++ b/docs/content/list.md
@@ -261,7 +261,7 @@ Missing a field that would be generally useful? [Open an issue](https://github.c
## See also
-- [wt select](@/select.md) — Interactive worktree picker with live preview
+- [`wt select`](@/select.md) — Interactive worktree picker with live preview
## Command reference
diff --git a/docs/content/llm-commits.md b/docs/content/llm-commits.md
index e067c0f21..3960f52e3 100644
--- a/docs/content/llm-commits.md
+++ b/docs/content/llm-commits.md
@@ -100,7 +100,7 @@ Squashes branch commits into one with LLM-generated message:
$ wt step squash
```
-See [wt merge](@/merge.md) and [wt step](@/step.md) for full documentation.
+See [`wt merge`](@/merge.md) and [`wt step`](@/step.md) for full documentation.
## Prompt templates
diff --git a/docs/content/merge.md b/docs/content/merge.md
index 753a68635..7110d46ac 100644
--- a/docs/content/merge.md
+++ b/docs/content/merge.md
@@ -55,7 +55,7 @@ wt merge --no-commit
1. **Squash** — Stages uncommitted changes, then combines all commits since target into one (like GitHub's "Squash and merge"). Use `--stage` to control what gets staged: `all` (default), `tracked`, or `none`. A backup ref is saved to `refs/wt-backup/<branch>`. With `--no-squash`, uncommitted changes become a separate commit and individual commits are preserved.
2. **Rebase** — Rebases onto target if behind. Skipped if already up-to-date. Conflicts abort immediately.
-3. **Pre-merge hooks** — Hooks run after rebase, before merge. Failures abort. See [wt hook](@/hook.md).
+3. **Pre-merge hooks** — Hooks run after rebase, before merge. Failures abort. See [`wt hook`](@/hook.md).
4. **Merge** — Fast-forward merge to the target branch. Non-fast-forward merges are rejected.
5. **Pre-remove hooks** — Hooks run before removing worktree. Failures abort.
6. **Cleanup** — Removes the worktree and branch. Use `--no-remove` to keep the worktree. When already on the target branch or in the main worktree, the worktree is preserved.
@@ -79,9 +79,9 @@ lint = "cargo clippy"
## See also
-- [wt step](@/step.md) — Run individual operations (commit, squash, rebase, push)
-- [wt remove](@/remove.md) — Remove worktrees without merging
-- [wt switch](@/switch.md) — Navigate to other worktrees
+- [`wt step`](@/step.md) — Run individual operations (commit, squash, rebase, push)
+- [`wt remove`](@/remove.md) — Remove worktrees without merging
+- [`wt switch`](@/switch.md) — Navigate to other worktrees
## Command reference
diff --git a/docs/content/remove.md b/docs/content/remove.md
index 7d854db62..60f86a1be 100644
--- a/docs/content/remove.md
+++ b/docs/content/remove.md
@@ -61,12 +61,12 @@ Removal runs in the background by default (returns immediately). Logs are writte
## Shortcuts
-`@` (current), `-` (previous), `^` (default branch). See [wt switch](@/switch.md#shortcuts).
+`@` (current), `-` (previous), `^` (default branch). See [`wt switch`](@/switch.md#shortcuts).
## See also
-- [wt merge](@/merge.md) — Remove worktree after merging
-- [wt list](@/list.md) — View all worktrees
+- [`wt merge`](@/merge.md) — Remove worktree after merging
+- [`wt list`](@/list.md) — View all worktrees
## Command reference
diff --git a/docs/content/select.md b/docs/content/select.md
index 437ab90f4..5ba5ed383 100644
--- a/docs/content/select.md
+++ b/docs/content/select.md
@@ -49,8 +49,8 @@ Branches without worktrees are included — selecting one creates a worktree. (`
## See also
-- [wt list](@/list.md) — Static table view with all worktree metadata
-- [wt switch](@/switch.md) — Direct switching to a known target branch
+- [`wt list`](@/list.md) — Static table view with all worktree metadata
+- [`wt switch`](@/switch.md) — Direct switching to a known target branch
## Command reference
diff --git a/docs/content/step.md b/docs/content/step.md
index bd67eeeab..6f1850244 100644
--- a/docs/content/step.md
+++ b/docs/content/step.md
@@ -38,8 +38,8 @@ wt step push
## See also
-- [wt merge](@/merge.md) — Runs commit → squash → rebase → hooks → push → cleanup automatically
-- [wt hook](@/hook.md) — Run configured hooks
+- [`wt merge`](@/merge.md) — Runs commit → squash → rebase → hooks → push → cleanup automatically
+- [`wt hook`](@/hook.md) — Run configured hooks
## Command reference
diff --git a/docs/content/switch.md b/docs/content/switch.md
index 9811a073a..527cf9c27 100644
--- a/docs/content/switch.md
+++ b/docs/content/switch.md
@@ -74,10 +74,10 @@ To change which branch a worktree is on, use `git switch` inside that worktree.
## See also
-- [wt select](@/select.md) — Interactive worktree selection
-- [wt list](@/list.md) — View all worktrees
-- [wt remove](@/remove.md) — Delete worktrees when done
-- [wt merge](@/merge.md) — Integrate changes back to the default branch
+- [`wt select`](@/select.md) — Interactive worktree selection
+- [`wt list`](@/list.md) — View all worktrees
+- [`wt remove`](@/remove.md) — Delete worktrees when done
+- [`wt merge`](@/merge.md) — Integrate changes back to the default branch
## Command reference
diff --git a/docs/content/tips-patterns.md b/docs/content/tips-patterns.md
index 02fe2a18b..daf6a4d46 100644
--- a/docs/content/tips-patterns.md
+++ b/docs/content/tips-patterns.md
@@ -153,7 +153,7 @@ Shows PR/CI status for all branches, including those without worktrees. CI indic
wt list --format=json
```
-Structured output for dashboards, statuslines, and scripts. See [wt list](@/list.md) for query examples.
+Structured output for dashboards, statuslines, and scripts. See [`wt list`](@/list.md) for query examples.
## Reuse `default-branch`
@@ -177,7 +177,7 @@ Reference Taskfile/Justfile/Makefile in hooks:
## Shortcuts
-Special arguments work across all commands—see [wt switch](@/switch.md#shortcuts) for the full list.
+Special arguments work across all commands—see [`wt switch`](@/switch.md#shortcuts) for the full list.
```bash
wt switch --create hotfix --base=@ # Branch from current HEAD
diff --git a/docs/content/worktrunk.md b/docs/content/worktrunk.md
index 9302e2fce..36c019af7 100644
--- a/docs/content/worktrunk.md
+++ b/docs/content/worktrunk.md
@@ -112,7 +112,7 @@ cargo install worktrunk && wt config shell install
## Next steps
-- Learn the core commands: [wt switch](@/switch.md), [wt list](@/list.md), [wt merge](@/merge.md), [wt remove](@/remove.md)
+- Learn the core commands: [`wt switch`](@/switch.md), [`wt list`](@/list.md), [`wt merge`](@/merge.md), [`wt remove`](@/remove.md)
- Set up [project hooks](@/hook.md) for automated setup
- Explore [LLM commit messages](@/llm-commits.md), [fzf-like
selector](@/select.md), [Claude Code integration](@/claude-code.md), [CI
diff --git a/src/cli.rs b/src/cli.rs
index 57bb39076..52022f92f 100644
--- a/src/cli.rs
+++ b/src/cli.rs
@@ -509,7 +509,7 @@ Without a subcommand, runs `get`."#
/// CI status cache
#[command(
name = "ci-status",
- after_long_help = r#"Caches GitHub/GitLab CI status for display in [wt list](@/list.md#ci-status).
+ after_long_help = r#"Caches GitHub/GitLab CI status for display in [`wt list`](@/list.md#ci-status).
## How it works
@@ -529,7 +529,7 @@ Without a subcommand, runs `get`."#
| `no-ci` | No checks configured |
| `error` | Fetch error (rate limit, network, auth) |
-See [wt list CI status](@/list.md#ci-status) for display symbols and colors.
+See [`wt list` CI status](@/list.md#ci-status) for display symbols and colors.
## When to use
@@ -1312,10 +1312,10 @@ To change which branch a worktree is on, use `git switch` inside that worktree.
## See also
-- [wt select](@/select.md) — Interactive worktree selection
-- [wt list](@/list.md) — View all worktrees
-- [wt remove](@/remove.md) — Delete worktrees when done
-- [wt merge](@/merge.md) — Integrate changes back to the default branch
+- [`wt select`](@/select.md) — Interactive worktree selection
+- [`wt list`](@/list.md) — View all worktrees
+- [`wt remove`](@/remove.md) — Delete worktrees when done
+- [`wt merge`](@/merge.md) — Integrate changes back to the default branch
"#
)]
Switch {
@@ -1595,7 +1595,7 @@ Missing a field that would be generally useful? Open an issue at https://github.
## See also
-- [wt select](@/select.md) — Interactive worktree picker with live preview
+- [`wt select`](@/select.md) — Interactive worktree picker with live preview
"#
)]
// TODO: `args_conflicts_with_subcommands` causes confusing errors for unknown
@@ -1690,12 +1690,12 @@ Removal runs in the background by default (returns immediately). Logs are writte
## Shortcuts
-`@` (current), `-` (previous), `^` (default branch). See [wt switch](@/switch.md#shortcuts).
+`@` (current), `-` (previous), `^` (default branch). See [`wt switch`](@/switch.md#shortcuts).
## See also
-- [wt merge](@/merge.md) — Remove worktree after merging
-- [wt list](@/list.md) — View all worktrees
+- [`wt merge`](@/merge.md) — Remove worktree after merging
+- [`wt list`](@/list.md) — View all worktrees
"#
)]
Remove {
@@ -1776,7 +1776,7 @@ wt merge --no-commit
1. **Squash** — Stages uncommitted changes, then combines all commits since target into one (like GitHub's "Squash and merge"). Use `--stage` to control what gets staged: `all` (default), `tracked`, or `none`. A backup ref is saved to `refs/wt-backup/<branch>`. With `--no-squash`, uncommitted changes become a separate commit and individual commits are preserved.
2. **Rebase** — Rebases onto target if behind. Skipped if already up-to-date. Conflicts abort immediately.
-3. **Pre-merge hooks** — Hooks run after rebase, before merge. Failures abort. See [wt hook](@/hook.md).
+3. **Pre-merge hooks** — Hooks run after rebase, before merge. Failures abort. See [`wt hook`](@/hook.md).
4. **Merge** — Fast-forward merge to the target branch. Non-fast-forward merges are rejected.
5. **Pre-remove hooks** — Hooks run before removing worktree. Failures abort.
6. **Cleanup** — Removes the worktree and branch. Use `--no-remove` to keep the worktree. When already on the target branch or in the main worktree, the worktree is preserved.
@@ -1800,9 +1800,9 @@ lint = "cargo clippy"
## See also
-- [wt step](@/step.md) — Run individual operations (commit, squash, rebase, push)
-- [wt remove](@/remove.md) — Remove worktrees without merging
-- [wt switch](@/switch.md) — Navigate to other worktrees
+- [`wt step`](@/step.md) — Run individual operations (commit, squash, rebase, push)
+- [`wt remove`](@/remove.md) — Remove worktrees without merging
+- [`wt switch`](@/switch.md) — Navigate to other worktrees
"#
)]
Merge {
@@ -1900,8 +1900,8 @@ Branches without worktrees are included — selecting one creates a worktree. (`
## See also
-- [wt list](@/list.md) — Static table view with all worktree metadata
-- [wt switch](@/switch.md) — Direct switching to a known target branch
+- [`wt list`](@/list.md) — Static table view with all worktree metadata
+- [`wt switch`](@/switch.md) — Direct switching to a known target branch
"#
)]
Select,
@@ -1939,8 +1939,8 @@ wt step push
## See also
-- [wt merge](@/merge.md) — Runs commit → squash → rebase → hooks → push → cleanup automatically
-- [wt hook](@/hook.md) — Run configured hooks
+- [`wt merge`](@/merge.md) — Runs commit → squash → rebase → hooks → push → cleanup automatically
+- [`wt hook`](@/hook.md) — Run configured hooks
<!-- subdoc: for-each -->
"#
@@ -2063,7 +2063,7 @@ cleanup = "rm -rf /tmp/cache/{{ branch }}"
- **pre-remove** — Before removing worktree during cleanup
- **post-merge** — After cleanup completes
-See [wt merge](@/merge.md#pipeline) for the complete pipeline.
+See [`wt merge`](@/merge.md#pipeline) for the complete pipeline.
## Configuration
@@ -2415,9 +2415,9 @@ fi
## See also
-- [wt merge](@/merge.md) — Runs hooks automatically during merge
-- [wt switch](@/switch.md) — Runs post-create/post-start hooks on `--create`
-- [wt config](@/config.md) — Manage hook approvals
+- [`wt merge`](@/merge.md) — Runs hooks automatically during merge
+- [`wt switch`](@/switch.md) — Runs post-create/post-start hooks on `--create`
+- [`wt config`](@/config.md) — Manage hook approvals
<!-- subdoc: approvals -->
"#
@@ -2568,7 +2568,7 @@ notify = "notify-send 'Merging {{ branch }}'"
User hooks run before project hooks and don't require approval. Skip with `--no-verify`.
-See [wt hook](@/hook.md#user-hooks) for complete documentation.
+See [`wt hook`](@/hook.md#user-hooks) for complete documentation.
## Project config
@@ -2585,7 +2585,7 @@ test = "npm test"
lint = "npm run lint"
```
-See [wt hook](@/hook.md) for complete documentation on hook types, execution order, template variables, and [JSON context](@/hook.md#json-context).
+See [`wt hook`](@/hook.md) for complete documentation on hook types, execution order, template variables, and [JSON context](@/hook.md#json-context).
### Dev server URL
diff --git a/src/md_help.rs b/src/md_help.rs
index ce8ce536d..290de06cf 100644
--- a/src/md_help.rs
+++ b/src/md_help.rs
@@ -394,6 +394,16 @@ mod tests {
);
}
+ #[test]
+ fn test_render_inline_formatting_backticks_in_link() {
+ // Backticks inside link text should be preserved and rendered as code
+ let result = render_inline_formatting("See [`wt hook`](@/hook.md) for details");
+ // Should contain dimmed "wt hook" (code style)
+ assert!(result.contains("\u{1b}[2mwt hook\u{1b}[0m"));
+ assert!(result.contains("See "));
+ assert!(result.contains(" for details"));
+ }
+
#[test]
fn test_render_inline_formatting_nested_brackets() {
assert_eq!(
diff --git a/tests/snapshots/integration__integration_tests__help__help_config_long.snap b/tests/snapshots/integration__integration_tests__help__help_config_long.snap
index f57acb25f..67af42c14 100644
--- a/tests/snapshots/integration__integration_tests__help__help_config_long.snap
+++ b/tests/snapshots/integration__integration_tests__help__help_config_long.snap
@@ -161,7 +161,7 @@ Personal hooks that run for all repositories. Use the same syntax as project hoo
User hooks run before project hooks and don't require approval. Skip with --no-verify.
-See wt hook for complete documentation.
+See wt hook for complete documentation.
Project config
@@ -176,7 +176,7 @@ Create .config/wt.toml in the repository root:
test = "npm test"
lint = "npm run lint"
-See wt hook for complete documentation on hook types, execution order, template variables, and JSON context.
+See wt hook for complete documentation on hook types, execution order, template variables, and JSON context.
Dev server URL
diff --git a/tests/snapshots/integration__integration_tests__help__help_config_state_ci_status.snap b/tests/snapshots/integration__integration_tests__help__help_config_state_ci_status.snap
index fb8e53aa6..23d757d26 100644
--- a/tests/snapshots/integration__integration_tests__help__help_config_state_ci_status.snap
+++ b/tests/snapshots/integration__integration_tests__help__help_config_state_ci_status.snap
@@ -13,6 +13,7 @@ info:
GIT_EDITOR: ""
RUST_LOG: warn
SOURCE_DATE_EPOCH: "1735776000"
+ TERM: alacritty
WORKTRUNK_CONFIG_PATH: /nonexistent/test/config.toml
WORKTRUNK_TEST_SKIP_URL_HEALTH_CHECK: "1"
---
@@ -43,7 +44,7 @@ Usage: wt config state ci-status [OPTIONS] [COMMAND]
-v, --verbose
Show commands and debug info
-Caches GitHub/GitLab CI status for display in wt list.
+Caches GitHub/GitLab CI status for display in wt list.
How it works
@@ -63,7 +64,7 @@ Caches GitHub/GitLab CI status for display in wt list.
no-ci No checks configured
error Fetch error (rate limit, network, auth)
-See wt list CI status for display symbols and colors.
+See wt list CI status for display symbols and colors.
When to use
diff --git a/tests/snapshots/integration__integration_tests__help__help_list_long.snap b/tests/snapshots/integration__integration_tests__help__help_list_long.snap
index 9e4de8d05..a8d4d6b10 100644
--- a/tests/snapshots/integration__integration_tests__help__help_list_long.snap
+++ b/tests/snapshots/integration__integration_tests__help__help_list_long.snap
@@ -268,4 +268,4 @@ Missing a field that would be generally useful? Open an issue at https://github.
See also
-- wt select — Interactive worktree picker with live preview
+- wt select — Interactive worktree picker with live preview
diff --git a/tests/snapshots/integration__integration_tests__help__help_list_narrow_80.snap b/tests/snapshots/integration__integration_tests__help__help_list_narrow_80.snap
index e9d558772..b87993a36 100644
--- a/tests/snapshots/integration__integration_tests__help__help_list_narrow_80.snap
+++ b/tests/snapshots/integration__integration_tests__help__help_list_narrow_80.snap
@@ -291,4 +291,4 @@ https://github.com/max-sixty/worktrunk.
See also
-- wt select — Interactive worktree picker with live preview
+- wt select — Interactive worktree picker with live preview
diff --git a/tests/snapshots/integration__integration_tests__help__help_md_merge.snap b/tests/snapshots/integration__integration_tests__help__help_md_merge.snap
index 56901e0cf..50061b77c 100644
--- a/tests/snapshots/integration__integration_tests__help__help_md_merge.snap
+++ b/tests/snapshots/integration__integration_tests__help__help_md_merge.snap
@@ -111,7 +111,7 @@ wt merge --no-commit
1. **Squash** — Stages uncommitted changes, then combines all commits since target into one (like GitHub's "Squash and merge"). Use `--stage` to control what gets staged: `all` (default), `tracked`, or `none`. A backup ref is saved to `refs/wt-backup/<branch>`. With `--no-squash`, uncommitted changes become a separate commit and individual commits are preserved.
2. **Rebase** — Rebases onto target if behind. Skipped if already up-to-date. Conflicts abort immediately.
-3. **Pre-merge hooks** — Hooks run after rebase, before merge. Failures abort. See [wt hook](@/hook.md).
+3. **Pre-merge hooks** — Hooks run after rebase, before merge. Failures abort. See [`wt hook`](@/hook.md).
4. **Merge** — Fast-forward merge to the target branch. Non-fast-forward merges are rejected.
5. **Pre-remove hooks** — Hooks run before removing worktree. Failures abort.
6. **Cleanup** — Removes the worktree and branch. Use `--no-remove` to keep the worktree. When already on the target branch or in the main worktree, the worktree is preserved.
@@ -135,9 +135,9 @@ lint = "cargo clippy"
## See also
-- [wt step](@/step.md) — Run individual operations (commit, squash, rebase, push)
-- [wt remove](@/remove.md) — Remove worktrees without merging
-- [wt switch](@/switch.md) — Navigate to other worktrees
+- [`wt step`](@/step.md) — Run individual operations (commit, squash, rebase, push)
+- [`wt remove`](@/remove.md) — Remove worktrees without merging
+- [`wt switch`](@/switch.md) — Navigate to other worktrees
----- stderr -----
diff --git a/tests/snapshots/integration__integration_tests__help__help_merge_long.snap b/tests/snapshots/integration__integration_tests__help__help_merge_long.snap
index 85d7037cf..2bea6b8b8 100644
--- a/tests/snapshots/integration__integration_tests__help__help_merge_long.snap
+++ b/tests/snapshots/integration__integration_tests__help__help_merge_long.snap
@@ -104,7 +104,7 @@ Skip committing/squashing (rebase still runs unless --no-rebase):
what gets staged: all (default), tracked, or none. A backup ref is saved to refs/wt-backup/<branch>. With --no-squash, uncommitted changes become a
separate commit and individual commits are preserved.
2. Rebase — Rebases onto target if behind. Skipped if already up-to-date. Conflicts abort immediately.
-3. Pre-merge hooks — Hooks run after rebase, before merge. Failures abort. See wt hook.
+3. Pre-merge hooks — Hooks run after rebase, before merge. Failures abort. See wt hook.
4. Merge — Fast-forward merge to the target branch. Non-fast-forward merges are rejected.
5. Pre-remove hooks — Hooks run before removing worktree. Failures abort.
6. Cleanup — Removes the worktree and branch. Use --no-remove to keep the worktree. When already on the target branch or in the main worktree, the
@@ -131,6 +131,6 @@ hooks validate before merging — if they pass, the branch goes to the default b
See also
-- wt step — Run individual operations (commit, squash, rebase, push)
-- wt remove — Remove worktrees without merging
-- wt switch — Navigate to other worktrees
+- wt step — Run individual operations (commit, squash, rebase, push)
+- wt remove — Remove worktrees without merging
+- wt switch — Navigate to other worktrees
diff --git a/tests/snapshots/integration__integration_tests__help__help_page_merge.snap b/tests/snapshots/integration__integration_tests__help__help_page_merge.snap
index 47049397a..cf56b9c9a 100644
--- a/tests/snapshots/integration__integration_tests__help__help_page_merge.snap
+++ b/tests/snapshots/integration__integration_tests__help__help_page_merge.snap
@@ -67,7 +67,7 @@ wt merge --no-commit
1. **Squash** — Stages uncommitted changes, then combines all commits since target into one (like GitHub's "Squash and merge"). Use `--stage` to control what gets staged: `all` (default), `tracked`, or `none`. A backup ref is saved to `refs/wt-backup/<branch>`. With `--no-squash`, uncommitted changes become a separate commit and individual commits are preserved.
2. **Rebase** — Rebases onto target if behind. Skipped if already up-to-date. Conflicts abort immediately.
-3. **Pre-merge hooks** — Hooks run after rebase, before merge. Failures abort. See [wt hook](@/hook.md).
+3. **Pre-merge hooks** — Hooks run after rebase, before merge. Failures abort. See [`wt hook`](@/hook.md).
4. **Merge** — Fast-forward merge to the target branch. Non-fast-forward merges are rejected.
5. **Pre-remove hooks** — Hooks run before removing worktree. Failures abort.
6. **Cleanup** — Removes the worktree and branch. Use `--no-remove` to keep the worktree. When already on the target branch or in the main worktree, the worktree is preserved.
@@ -91,9 +91,9 @@ lint = "cargo clippy"
## See also
-- [wt step](@/step.md) — Run individual operations (commit, squash, rebase, push)
-- [wt remove](@/remove.md) — Remove worktrees without merging
-- [wt switch](@/switch.md) — Navigate to other worktrees
+- [`wt step`](@/step.md) — Run individual operations (commit, squash, rebase, push)
+- [`wt remove`](@/remove.md) — Remove worktrees without merging
+- [`wt switch`](@/switch.md) — Navigate to other worktrees
## Command reference
diff --git a/tests/snapshots/integration__integration_tests__help__help_page_switch.snap b/tests/snapshots/integration__integration_tests__help__help_page_switch.snap
index 2bf5894d1..1587278a4 100644
--- a/tests/snapshots/integration__integration_tests__help__help_page_switch.snap
+++ b/tests/snapshots/integration__integration_tests__help__help_page_switch.snap
@@ -86,10 +86,10 @@ To change which branch a worktree is on, use `git switch` inside that worktree.
## See also
-- [wt select](@/select.md) — Interactive worktree selection
-- [wt list](@/list.md) — View all worktrees
-- [wt remove](@/remove.md) — Delete worktrees when done
-- [wt merge](@/merge.md) — Integrate changes back to the default branch
+- [`wt select`](@/select.md) — Interactive worktree selection
+- [`wt list`](@/list.md) — View all worktrees
+- [`wt remove`](@/remove.md) — Delete worktrees when done
+- [`wt merge`](@/merge.md) — Integrate changes back to the default branch
## Command reference
diff --git a/tests/snapshots/integration__integration_tests__help__help_remove_long.snap b/tests/snapshots/integration__integration_tests__help__help_remove_long.snap
index 478847051..4341cf0de 100644
--- a/tests/snapshots/integration__integration_tests__help__help_remove_long.snap
+++ b/tests/snapshots/integration__integration_tests__help__help_remove_long.snap
@@ -110,9 +110,9 @@ the foreground.
Shortcuts
-@ (current), - (previous), ^ (default branch). See wt switch.
+@ (current), - (previous), ^ (default branch). See wt switch.
See also
-- wt merge — Remove worktree after merging
-- wt list — View all worktrees
+- wt merge — Remove worktree after merging
+- wt list — View all worktrees
diff --git a/tests/snapshots/integration__integration_tests__help__help_step_long.snap b/tests/snapshots/integration__integration_tests__help__help_step_long.snap
index 8177b0d3c..cc2d85669 100644
--- a/tests/snapshots/integration__integration_tests__help__help_step_long.snap
+++ b/tests/snapshots/integration__integration_tests__help__help_step_long.snap
@@ -71,5 +71,5 @@ Manual merge workflow with review between steps:
See also
-- wt merge — Runs commit → squash → rebase → hooks → push → cleanup automatically
-- wt hook — Run configured hooks
+- wt merge — Runs commit → squash → rebase → hooks → push → cleanup automatically
+- wt hook — Run configured hooks
diff --git a/tests/snapshots/integration__integration_tests__help__help_switch_long.snap b/tests/snapshots/integration__integration_tests__help__help_switch_long.snap
index 6acd855d1..d69a5b5f1 100644
--- a/tests/snapshots/integration__integration_tests__help__help_switch_long.snap
+++ b/tests/snapshots/integration__integration_tests__help__help_switch_long.snap
@@ -134,7 +134,7 @@ To change which branch a worktree is on, use git switch inside that work
See also
-- wt select — Interactive worktree selection
-- wt list — View all worktrees
-- wt remove — Delete worktrees when done
-- wt merge — Integrate changes back to the default branch
+- wt select — Interactive worktree selection
+- wt list — View all worktrees
+- wt remove — Delete worktrees when done
+- wt merge — Integrate changes back to the default branch