From 581e3a07419559d2c20c7cab0d8a04ea626e124c Mon Sep 17 00:00:00 2001 From: nimma15 Date: Thu, 25 Jun 2026 19:49:09 +0500 Subject: [PATCH 1/2] docs:clarify that Alt-g is Option-g on macOS - Adding this label helps macOS users understand how to trigger the key menu since the Alt key is labeled 'Option' on their keyboards. --- runtime/help/help.md | 2 +- runtime/help/keybindings.md | 2 +- runtime/help/options.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/runtime/help/help.md b/runtime/help/help.md index 185e953ac0..345b2b5955 100644 --- a/runtime/help/help.md +++ b/runtime/help/help.md @@ -10,7 +10,7 @@ display. From now on, when the documentation shows a command to run (such as For a list of the default keybindings, run `> help defaultkeys`. For more information on keybindings, see `> help keybindings`. -To toggle a short list of important keybindings, press Alt-g. +To toggle a short list of important keybindings, press Alt-g (Option-g on Mac). ## Quick-start diff --git a/runtime/help/keybindings.md b/runtime/help/keybindings.md index 50dc4057c4..9883134330 100644 --- a/runtime/help/keybindings.md +++ b/runtime/help/keybindings.md @@ -593,7 +593,7 @@ conventions for text editing defaults. "ShiftPageUp": "SelectPageUp", "ShiftPageDown": "SelectPageDown", "Ctrl-g": "ToggleHelp", - "Alt-g": "ToggleKeyMenu", + "Alt-g": "ToggleKeyMenu", (Option-g on Mac) "Ctrl-r": "ToggleRuler", "Ctrl-l": "command-edit:goto ", "Delete": "Delete", diff --git a/runtime/help/options.md b/runtime/help/options.md index 4d086698b7..18c5234470 100644 --- a/runtime/help/options.md +++ b/runtime/help/options.md @@ -224,7 +224,7 @@ Here are the available options: default value: `false` * `keymenu`: display the nano-style key menu at the bottom of the screen. Note - that ToggleKeyMenu is bound to `Alt-g` by default and this is displayed in + that ToggleKeyMenu is bound to `Alt-g` (Option-g on Mac) by default and this is displayed in the statusline. To disable the key binding, bind `Alt-g` to `None`. default value: `false` From f354fe9ce437f4a882cdaed68d180f47af46cc1c Mon Sep 17 00:00:00 2001 From: nimma15 Date: Thu, 25 Jun 2026 19:53:09 +0500 Subject: [PATCH 2/2] feat: visually display 'Option' instead of 'Alt' in statusline on macOS - The statusline dynamically looks up keybindings to display. - This intercepts 'Alt' bindings and visually replaces 'Alt' with 'Option' for macOS users, making it instantly recognizable on Apple keyboards. --- internal/display/statusline.go | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/internal/display/statusline.go b/internal/display/statusline.go index 3500355b13..3acc9e546c 100644 --- a/internal/display/statusline.go +++ b/internal/display/statusline.go @@ -4,6 +4,7 @@ import ( "bytes" "fmt" "regexp" + "runtime" "strconv" "strings" @@ -157,6 +158,9 @@ func (s *StatusLine) Display() { binding := string(name[5:]) for k, v := range config.Bindings["buffer"] { if v == binding { + if runtime.GOOS == "darwin" { + k = strings.Replace(k, "Alt", "Option", -1) + } return []byte(k) } }