Space Menu
The space menu contains two major keymaps:
- Left
- Right
The Left side contains the keymap of Global secondary selection modes.
The right side is a handy shortcut for (not restricted to):
- Contextual actions
- File and quit actions
- Searching files/symbols
- Multi-cursor management
- Opening other components
The space menu can be brought up by pressing space.
Keymap
LSP Actions (only applicable in the main editor):
| Label | Action |
|---|---|
Code Actions | Request code actions |
Hover | Request hover info |
Rename | Rename current symbol |
Pick
Searching behavior
Searching is powered by Helix's Nucleo, and some fzf-esque search syntax works here:
| Token | Description |
|---|---|
sbt | Items that match sbt, for example serbian-bear-tinker |
'wild | Items that must include wild |
.mp3$ | Items that end with .mp3 |
Search terms can be separated by space, which means AND, and their order is unimportant.
For example, the search query stb 'wild matches wild-serbian-bear-tiger and also stubbornly_wild.
Also, you can use the initals to search for a file, for example, ekl matches editor_keymap_legend.rs.
Because every component is a buffer/editor, fuzzy search logic is also used for filtering LSP completions.
Buffer Behavior
The buffer navigation, including the Buffer List and Previous/Next Buffer options, displays only files that have been directly opened or edited by the user. Files that are merely displayed, such as those from search results or diagnostic messages, do not automatically become part of the buffer list.
For example, if you rename a symbol in file1.rs and this causes an error in file2.rs, file2.rs
will be shown when navigating diagnostic messages. However, unless you edit file2.rs, it will not be
added to the buffer list. Similarly, if you search your project and view results in multiple files,
these files will not be included in the buffer list unless you edit them.
Theme
Symbol
LSP Symbols
File
Files (Not git ignored)
Buffer
Buffers (opened files)
Git status @
Git status (against current branch) 1
Git status ^
Git status (against main branch) 2
Editor
Quit No Save
Quit Ki without saving any unsaved files.
Save All Quit
Save all files and quit Ki.
Save All
Save all files.
Pipe
Open a prompt which takes a shell command that treats the current selections as STDIN, and replace the current selections with the STDOUT of the command.
Replace all
Replace all matches across all files of the current working directory with the specified replacement.
For example, if the search query is l hello_world bye_moon, it will replaces all hello_world across all files with bye_moon.
See more at Search in Ki.
TS Node Sexp
Show the Tree-sitter node S-expression of the current selection.
Explorer
Reveal current file in file explorer.
Help
Shows the Normal mode keymap.
Reveal
Reveal is a powerful viewport management feature that provides a bird's-eye view of your code or text. It automatically divides your viewport horizontally to show all relevant selections simultaneously, eliminating the need for scrolling (unless selections exceed the viewport height).
There are 3 kinds of Reveals:
÷ Selection (Reveal Selections)
Reveal Selections dynamically creates viewports based on the selections of the current selection mode. This is particularly powerful for non-contiguous (secondary) selections created through Search, LSP Diagnostics, Git Hunks, and other multi-selection modes.
When used with Syntax Node selection mode, it can effectively emulate Code Folding, allowing you to view all sibling nodes of the current selected node, such as:
- Viewing all functions of the current module
- Viewing all methods of the current class
- Viewing all statements of the current block
- Viewing all subheaders under a header in a Markdown file
÷ Cursor (Reveal Cursors)
Reveal Cursors is not just useful, but essential when working with multiple cursors. It provides visual confirmation and confidence that your editing operations will be correctly applied across all cursor positions. This is particularly valuable for bulk editing operations where precision is crucial.
÷ Mark (Reveal Marks)
Reveal Mark offers a modern alternative to traditional window splitting. Rather than manually managing multiple editor windows, you can mark and instantly view important sections simultaneously. You can think of it as automated window splitting.