Skip to content

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

Note in wt switch docs that Alt is Option on macOS (#4483)

Worktrunk Bot7c265fc730b4
diff --git a/docs/src/content/docs/switch.md b/docs/src/content/docs/switch.md
index 69f224280..1f7bcb181 100644
--- a/docs/src/content/docs/switch.md
+++ b/docs/src/content/docs/switch.md
@@ -123,6 +123,8 @@ The CI column shows each row's PR/MR CI and review status, the same as [`wt list
| `Alt-p` | Toggle preview panel |
| `Ctrl-u`/`Ctrl-d` | Scroll preview up/down |
+On macOS, `Alt` is the Option key; the terminal needs to send it as Meta (e.g. Terminal.app's [Use Option as Meta key](https://support.apple.com/guide/terminal/change-profiles-keyboard-settings-trmlkbrd/mac)).
+
The filter matches each row's branch, path, and — when it has a PR/MR — the PR/MR's number, title, and author. Typing `+` narrows to linked worktrees, and `@` to the current worktree.
**Preview tabs:**
diff --git a/plugins/worktrunk/skills/worktrunk/reference/switch.md b/plugins/worktrunk/skills/worktrunk/reference/switch.md
index 92358763e..3f6909774 100644
--- a/plugins/worktrunk/skills/worktrunk/reference/switch.md
+++ b/plugins/worktrunk/skills/worktrunk/reference/switch.md
@@ -99,6 +99,8 @@ The CI column shows each row's PR/MR CI and review status, the same as [`wt list
| `Alt-p` | Toggle preview panel |
| `Ctrl-u`/`Ctrl-d` | Scroll preview up/down |
+On macOS, `Alt` is the Option key; the terminal needs to send it as Meta (e.g. Terminal.app's [Use Option as Meta key](https://support.apple.com/guide/terminal/change-profiles-keyboard-settings-trmlkbrd/mac)).
+
The filter matches each row's branch, path, and — when it has a PR/MR — the PR/MR's number, title, and author. Typing `+` narrows to linked worktrees, and `@` to the current worktree.
**Preview tabs:**
diff --git a/skills/worktrunk/reference/switch.md b/skills/worktrunk/reference/switch.md
index 92358763e..3f6909774 100644
--- a/skills/worktrunk/reference/switch.md
+++ b/skills/worktrunk/reference/switch.md
@@ -99,6 +99,8 @@ The CI column shows each row's PR/MR CI and review status, the same as [`wt list
| `Alt-p` | Toggle preview panel |
| `Ctrl-u`/`Ctrl-d` | Scroll preview up/down |
+On macOS, `Alt` is the Option key; the terminal needs to send it as Meta (e.g. Terminal.app's [Use Option as Meta key](https://support.apple.com/guide/terminal/change-profiles-keyboard-settings-trmlkbrd/mac)).
+
The filter matches each row's branch, path, and — when it has a PR/MR — the PR/MR's number, title, and author. Typing `+` narrows to linked worktrees, and `@` to the current worktree.
**Preview tabs:**
diff --git a/src/cli/mod.rs b/src/cli/mod.rs
index 8cec21391..7936a06e1 100644
--- a/src/cli/mod.rs
+++ b/src/cli/mod.rs
@@ -740,6 +740,8 @@ The CI column shows each row's PR/MR CI and review status, the same as [`wt list
| `Alt-p` | Toggle preview panel |
| `Ctrl-u`/`Ctrl-d` | Scroll preview up/down |
+On macOS, `Alt` is the Option key; the terminal needs to send it as Meta (e.g. Terminal.app's [Use Option as Meta key](https://support.apple.com/guide/terminal/change-profiles-keyboard-settings-trmlkbrd/mac)).
+
The filter matches each row's branch, path, and — when it has a PR/MR — the PR/MR's number, title, and author. Typing `+` narrows to linked worktrees, and `@` to the current worktree.
**Preview tabs:**
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 a63241715..b4dad3430 100644
--- a/tests/snapshots/integration__integration_tests__help__help_switch_long.snap
+++ b/tests/snapshots/integration__integration_tests__help__help_switch_long.snap
@@ -233,6 +233,8 @@ The CI column shows each row's PR/MR CI and review status, the same as wt li
Alt-p Toggle preview panel
Ctrl-u/Ctrl-d Scroll preview up/down
+On macOS, Alt is the Option key; the terminal needs to send it as Meta (e.g. Terminal.app's Use Option as Meta key).
+
The filter matches each row's branch, path, and — when it has a PR/MR — the PR/MR's number, title, and author. Typing + narrows to linked worktrees, and @ to the current worktree.
Preview tabs: