The "modal mode", which may be familiar to vim users, changes a little the way you interact with broot:

I recommand you don't activate this mode until you really tried broot. Broot isn't a text editor and can't be confused with one. This mode may be more comfortable when you constantly jump from vim to broot but only after you understood how broot works. You may be an avid vim user, as I am, and still prefer not to use modality in broot. Starting in command mode means you have one more letter to type before searching, because search is done in input mode. And broot is search oriented and often used in very short sessions (less than 5 seconds from intent to launch to being back in the shell in the right directory or editing the right file in your favorite editor)


You need first to enable the "modal mode" with this line in the configuration:

modal: true
modal = true

(note: it must be at the begining of the configuration if it's in TOML)

If modal isn't set to true, the single letter shortcuts you define in configuration will be ignored (so you don't have to remove them if you don't want modality anymore).


Broot may be in one of two modes:

  1. input mode, with the input field at the bottom focused and received standard keys
  2. command mode, with input not focused, and single key shortcuts enabled

In command mode, you'll find those keys already configured: j and k to go down and up ̀ handl` to go to parent or to enter a directory

You enter input mode by typing one of those letters: (space), :, or /. You leave it with the escape key. You may add other bindings to the :mode_input and :mode_command verbs.