aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorMichelle Tilley <michelle@michelletilley.net>2026-01-16 11:10:41 -0800
committerGitHub <noreply@github.com>2026-01-16 11:10:41 -0800
commitbd74956473d9bddfbb8cd6206268388fb341a31c (patch)
tree52c9cf838bfbaa515ae84ab3c866a445d71b0758 /docs
parentUpdate installation.mdx (#3078) (diff)
downloadatuin-bd74956473d9bddfbb8cd6206268388fb341a31c.zip
Document key binding issue on Ghostty for Linux (#3073)
**Migrated from atuinsh/docs PR:** https://github.com/atuinsh/docs/pull/89 **Original author:** @matthewberryman --- *Original PR had no description.* Co-authored-by: Matthew Berryman <matthew@acrossthecloud.net> Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
Diffstat (limited to 'docs')
-rw-r--r--docs/docs/configuration/key-binding.md15
1 files changed, 15 insertions, 0 deletions
diff --git a/docs/docs/configuration/key-binding.md b/docs/docs/configuration/key-binding.md
index 7f57e987..763ead50 100644
--- a/docs/docs/configuration/key-binding.md
+++ b/docs/docs/configuration/key-binding.md
@@ -60,6 +60,21 @@ macOS does not have an ++alt++ key, although terminal emulators can often be con
ctrl_n_shortcuts = true
```
+Ghostty on Linux maps ++alt+1++ .. ++alt+9++ for switching between tabs by number. To disable this behavior either add the following to ~/.config/ghostty/config:
+```
+keybind=alt+one=unbind
+keybind=alt+two=unbind
+keybind=alt+three=unbind
+keybind=alt+four=unbind
+keybind=alt+five=unbind
+keybind=alt+six=unbind
+keybind=alt+seven=unbind
+keybind=alt+eight=unbind
+keybind=alt+nine=unbind
+```
+(this will disable tab switching by ++alt+n++)
+or use the `ctrl_n_shortcuts` as outlined above.
+
## zsh
If you'd like to customize your bindings further, it's possible to do so with custom shell config: