From 7cc893d67d09cb5ce076299e894baf9d97cfe4d7 Mon Sep 17 00:00:00 2001 From: Maxim Uvarov Date: Tue, 18 Apr 2023 04:24:25 +0800 Subject: [PATCH] Add keyboard shortcuts to the Config/Keybinding chapter. (#875) * Added Shortcuts section to keybinings * Removed obvious shortcuts * Update docs/docs/config/key-binding.md Co-authored-by: Ellie Huxtable * Update docs/docs/config/key-binding.md Co-authored-by: Conrad Ludgate * replaced cursor keys with emojis * got back to utf symbols --------- Co-authored-by: Ellie Huxtable Co-authored-by: Conrad Ludgate --- docs/docs/config/key-binding.md | 34 ++++++++++++++++++++++++++++++--- 1 file changed, 31 insertions(+), 3 deletions(-) diff --git a/docs/docs/config/key-binding.md b/docs/docs/config/key-binding.md index ecd9267..3db4ab0 100644 --- a/docs/docs/config/key-binding.md +++ b/docs/docs/config/key-binding.md @@ -1,5 +1,7 @@ # Key binding +## Shell + By default, Atuin will rebind both Ctrl-r and the up arrow. You can also disable either the up-arrow or Ctrl-r bindings individually, by passing @@ -28,7 +30,7 @@ eval "$(atuin init zsh)" You can then choose to bind Atuin if needed, do this after the call to init. -# zsh +### zsh Atuin defines the ZLE widget "\_atuin_search_widget" @@ -43,7 +45,7 @@ bindkey '^[[A' _atuin_search_widget bindkey '^[OA' _atuin_search_widget ``` -# bash +### bash ``` export ATUIN_NOBIND="true" @@ -53,7 +55,7 @@ eval "$(atuin init bash)" bind -x '"\C-r": __atuin_history' ``` -# fish +### fish ``` set -gx ATUIN_NOBIND "true" @@ -63,3 +65,29 @@ atuin init fish | source bind \cr _atuin_search bind -M insert \cr _atuin_search ``` + +## Atuin UI shortcuts + +| Shortcut | Action | +| ----------------------------------------- | ----------------------------------------------------------------------------- | +| ctrl + r | Cycle through filter modes | +| ctrl + s | Cycle through search modes | +| alt + 1 to alt + 9 | Select item by the number located near it | +| ctrl + c / ctrl + d / ctrl + g / esc | Return original | +| ctrl + ⬅︎ / alt + b | Move the cursor to the previous word | +| ctrl + ➡️ / alt + f | Move the cursor to the next word | +| ctrl + h / ctrl + b / ⬅︎ | Move the cursor to the left | +| ctrl + l / ctrl + f / ➡️ | Move the cursor to the right | +| ctrl + a / home | Move the cursor to the start of the line | +| ctrl + e / end | Move the cursor to the end of the line | +| ctrl + backspace / ctrl + alt + backspace | Remove the previous word / remove the word just before the cursor | +| ctrl + delete / ctrl + alt + delete | Remove the next word or the word just after the cursor | +| ctrl + w | Remove the word before the cursor even if it spans across the word boundaries | +| ctrl + u | Clear the current line | +| ctrl + n / ctrl + j / ⬆ | Select the next item on the list | +| ctrl + p / ctrl + k / ⬇ | Select the previous item on the list | +| page down | Scroll search results one page down | +| page up | Scroll search results one page up | +| enter | Select highlighted item | +| ⬇ (with no entry selected) | Return original or return query depending on settings | +| ⬇ | Select the next item on the list |