User guide / Commands

The command palette

Development reference · View source

: opens the command palette: every command with its aliases, usage, and a short description, grouped by category.

Exact names and aliases rank first, followed by name or alias prefixes, then matches in descriptions and other metadata. For example, :t and :term offer :terminal first, while :tu offers :tutorial first.

• Commands whose service is unavailable for the active buffer stay listed but dimmed, with a reason. Running one leaves the typed command and editor state alone.
• :: opens the plugin-only palette; see Plugins .

Path arguments

Once a command taking a path is selected, the rows become filesystem hints, from the editor working directory or from the absolute path being typed.

• Directories come first, with a trailing separator. Completing one keeps the palette open for its children. Running :open on a directory opens the explorer.
• ~ means your home directory, so :open ~/.bashrc and :open ~/projects work without a shell.
• Dotfiles are offered when the name typed begins with ., or when hidden files are enabled.

Enter in path prompts behaves the same everywhere: the palette’s path arguments, the Space / p finder path, and plugin fields that complete local paths.

• :cd sr Enter Enter completes to src/, then changes into it.
• A new name that is a prefix of an existing one is completed too: :w notes beside notes.md becomes :w notes.md. Hints follow only a cursor at the end of the line, so press Left, then Enter, to submit notes as typed.
• Completion inside a buffer — words, language-server items, paths — still uses only Tab; Enter there inserts a newline.

The working directory

The working directory starts where Runyte was launched.

• :cd <path> changes it. Relative paths resolve from the current working directory. With an explorer active, :cd also retargets that explorer; from a file, the file stays open.
• Space E opens the working directory. Space e opens the active buffer’s directory and selects its file, so Enter returns to it; from a rendered Markdown page it uses the source document. A pathless buffer falls back to the working directory.
• Space f (or Space / f) always opens the project Finder in name mode, and :fuzzy-grep its content mode.
• :file-picker-directory and :fuzzy-grep-directory search the active file’s parent, the active explorer’s root, or the working directory for a pathless or generated buffer.