Skip to main content
Vorto provides two complementary ways to perform higher-level actions without leaving the keyboard: the command-line prompt and the fuzzy finder. The command prompt lets you run named commands by typing them explicitly; the fuzzy finder opens interactive pickers that filter large lists as you type.

​
Command mode

Press : in Normal mode to open the command prompt at the bottom of the screen. Type a command name and press Enter to run it, or press Esc to cancel. The prompt supports Tab completion for command names and, where applicable, for file paths. Press Tab to cycle forward through candidates and Shift-Tab to cycle backward.

​
File and session commands

​
Buffer management

:bookmarks is the command form of the Space m bookmark sub-leader, and :jumps mirrors Space j. See Jumps & bookmarks.

​
Window / split management

​
Git conflicts

Navigate between conflicts with ]c / [c. See Conflicts & reload.

​
LSP and diagnostics

​
Grammars

In the modal, j / k move the selection, Enter installs, d removes, and / filters the list as you type. Installs run in the background and re-highlight the active buffer on completion, so colors appear without a restart. See Install and manage grammars.

​
AI agents

The agent runs under a pseudo-terminal inside Vorto. While its pane is focused, every key goes to the agent except Ctrl-W, which moves window focus (Ctrl-W h/j/k/l/w). See AI agents.

​
Configuration

:config-reload re-reads your config using the same path resolution as startup and re-applies the keymap, cursor shapes, [editor] / [finder] options, the agent catalog, grammar recipes, and the active theme. A load or parse error leaves the running config untouched and shows a toast. Already-running subsystems — LSP servers and the syntax / preview workers — keep their startup snapshot and need a restart to pick up changes. See Configuration overview.

​
Theming

The picker previews each theme on the current buffer as you move the cursor; Enter applies and persists it to config.toml, Esc reverts. See Themes.

​
Utilities

​
Fuzzy finder

The fuzzy finder opens a full-screen picker that narrows a large list as you type. All fuzzy pickers share the same key model:

​
File picker

Open with Space f in Normal mode. The picker lists all files in the current workspace, respecting .gitignore rules and hiding dotfile paths (files or directories whose name starts with .).
Press Space F (uppercase) to include dotfiles such as .env and .github/ in the list. .gitignore rules still apply.

​
Line picker

Open with Space l in Normal mode. The picker lists every line in the active buffer. Selecting a line jumps the cursor to that position. Open with Space / in Normal mode. This picker performs a substring search across every line of every tracked file in the workspace. The query uses smart-case matching: a fully lowercase query is case-insensitive; any uppercase character makes the search case-sensitive. Selecting a result jumps directly to the matched line and column.

​
Buffer picker

Open with Space b in Normal mode, or run :bls / :buffers from the command prompt. The picker lists all currently open buffers, most recently used first. Selecting a buffer switches to it.

​
Changed-file picker

Open with Space g in Normal mode. The picker lists every file that differs from HEAD (the same set git status reports), as root-relative paths with the same live preview as the file picker. Selecting one opens it. Outside a git repository, or when the working tree is clean, Vorto reports “no changed files” rather than opening an empty picker.

​
File explorer

Open with Space e in Normal mode. Unlike the fuzzy file picker, the explorer is a persistent tree view of the workspace directory. By default, a chain of directories where each link is the only child of its parent is folded into a single row (the VS Code “compact folders” behavior); set compact_folders = false to give every directory its own row. Selecting a file opens it in the active pane.

​
Diagnostics picker

The diagnostics picker lists LSP errors, warnings, and hints. Selecting an entry jumps to the affected location in the relevant file.

​
References picker

The references picker opens automatically when you run gr (find references) in Normal mode or use gd / gD / gi for LSP navigation when multiple results are returned. It uses the same picker interface as the other fuzzy finders.

​
Jump history picker

Open with Space j in Normal mode, or run :jumps. The picker lists the per-pane jumplist — the positions you jumped from — most recent first. Selecting an entry jumps back to it. See Jumps & bookmarks.

​
Bookmark picker

Open with Space m m in Normal mode, or run :bookmarks / :bm. The picker lists your bookmarks for the current project; selecting one jumps to it. See Jumps & bookmarks.