> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vorto-editor.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Vorto command prompt and fuzzy finder pickers reference

> Reference for Vorto's command prompt (`:` commands for saving, quitting, buffers, and splits) and the fuzzy finder pickers for files, buffers, and diagnostics.

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

| Command       | Aliases                  | Description                                                                                     |
| ------------- | ------------------------ | ----------------------------------------------------------------------------------------------- |
| `:w`          | `:write`                 | Save the current buffer                                                                         |
| `:w <path>`   | `:write <path>`          | Save to a specific path                                                                         |
| `:w!`         | `:write!`                | Save, creating any missing parent directories                                                   |
| `:wa`         | `:wall`, `:write-all`    | Save every dirty buffer (active, parked, and sleeping); skips clean and unnamed scratch buffers |
| `:wa!`        | `:wall!`, `:write-all!`  | Save all, overwriting any file that drifted on disk since load                                  |
| `:wqa`        | `:xa`, `:xall`, `:wqall` | Save every dirty buffer and quit (only quits when all wrote cleanly)                            |
| `:wqa!`       | `:xa!`, `:wqall!`        | Save all (overwriting disk drift) and quit                                                      |
| `:q`          | `:quit`                  | Quit                                                                                            |
| `:q!`         | `:quit!`                 | Force quit, discarding unsaved changes                                                          |
| `:wq`         | `:x`                     | Save and quit                                                                                   |
| `:e <path>`   | `:edit <path>`           | Open a file                                                                                     |
| `:reload`     | `:e!`                    | Reload the current buffer from disk (undo restores the pre-reload state)                        |
| `:reload-all` |                          | Reload every file-backed buffer from disk                                                       |
| `:new`        | `:enew`                  | Open a new scratch buffer                                                                       |

### Buffer management

| Command | Aliases                    | Description                                                             |
| ------- | -------------------------- | ----------------------------------------------------------------------- |
| `:bn`   | `:bnext`                   | Switch to the next buffer                                               |
| `:bp`   | `:bprev`                   | Switch to the previous buffer                                           |
| `:bd`   | `:bdelete`                 | Delete (close) the current buffer; refuses if there are unsaved changes |
| `:bd!`  | `:bdelete!`, `:bc`, `:bc!` | Force-delete the current buffer, discarding unsaved changes             |
| `:bca`  | `:bca!`                    | Force-delete every buffer and open a fresh scratch                      |
| `:bls`  | `:buffers`                 | Open the buffer picker                                                  |

### Navigation

| Command             | Aliases      | Description                                          |
| ------------------- | ------------ | ---------------------------------------------------- |
| `:goto <n>`         |              | Jump to line `n`                                     |
| `:jumps`            |              | Open the jump history picker                         |
| `:bookmarks`        | `:bm`        | Open the bookmark picker (same as `:bookmarks list`) |
| `:bookmarks add`    | `:bm add`    | Bookmark the current buffer at the cursor            |
| `:bookmarks delete` | `:bm delete` | Remove the current buffer's bookmark                 |

`:bookmarks` is the command form of the `Space m` bookmark sub-leader, and `:jumps` mirrors `Space j`. See [Jumps & bookmarks](/editing/navigation).

### Window / split management

| Command   | Aliases              | Description                                                |
| --------- | -------------------- | ---------------------------------------------------------- |
| `:split`  | `:sp`, `:nh`         | Open a new pane below the active one                       |
| `:vsplit` | `:vsp`, `:vs`, `:nv` | Open a new pane to the right                               |
| `:close`  | `:clo`               | Close the active pane (refuses on the last remaining pane) |

### Search

| Command          | Aliases                | Description                                          |
| ---------------- | ---------------------- | ---------------------------------------------------- |
| `:noh`           | `:nohl`, `:nohlsearch` | Clear the active search highlight                    |
| `:s/pat/repl/`   |                        | Substitute `pat` with `repl` on the current line     |
| `:%s/pat/repl/`  |                        | Substitute `pat` with `repl` across the whole buffer |
| `:%s/pat/repl/g` |                        | Substitute all occurrences on every line             |

### Git conflicts

| Command            | Description                                                             |
| ------------------ | ----------------------------------------------------------------------- |
| `:conflict ours`   | Resolve the conflict at the cursor, keeping the top (ours / local) side |
| `:conflict theirs` | Resolve it keeping the bottom (theirs / disk) side                      |
| `:conflict both`   | Keep both sides, dropping only the markers                              |
| `:conflict none`   | Delete the whole conflict block                                         |

Navigate between conflicts with `]c` / `[c`. See [Conflicts & reload](/editing/conflicts).

### LSP and diagnostics

| Command    | Description                                             |
| ---------- | ------------------------------------------------------- |
| `:lsp`     | Show the LSP status panel for the current buffer        |
| `:lsp all` | Show the LSP status panel for every configured language |

### Grammars

| Command                             | Description                                            |
| ----------------------------------- | ------------------------------------------------------ |
| `:grammar`                          | Open the grammar install modal (alias `:grammar list`) |
| `:grammar install <name>… \| --all` | Install grammars without leaving the editor            |
| `:grammar remove <name>…`           | Remove installed 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](/languages/grammars#installing-grammars-from-the-editor).

### AI agents

| Command                     | Description                                                                                                          |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| `:agent`                    | Launch the default AI agent in a built-in pane (opens a picker the first time); re-running focuses the existing pane |
| `:agent explain @file`      | Launch or focus the agent with a prompt to explain the active buffer                                                 |
| `:agent chat @file`         | Launch or focus the agent with an open-ended prompt about the active buffer                                          |
| `:agent explain @selection` | Same, scoped to the visual selection (select first, then press `:`)                                                  |
| `:agent chat @selection`    | Same, scoped to the visual selection                                                                                 |

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](/editing/agent).

### Configuration

| Command          | Aliases          | Description                                                          |
| ---------------- | ---------------- | -------------------------------------------------------------------- |
| `:config-reload` | `:reload-config` | Re-read `config.toml` and re-apply the settings that can change live |

`: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](/configuration/overview).

### Theming

| Command  | Aliases                 | Description                             |
| -------- | ----------------------- | --------------------------------------- |
| `:theme` | `:colorscheme`, `:colo` | Open the theme picker with live preview |

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](/configuration/themes).

### Utilities

| Command | Description                   |
| ------- | ----------------------------- |
| `:log`  | Open the Vorto debug log file |

***

## 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:

| Key              | Action                      |
| ---------------- | --------------------------- |
| Any character    | Filter the list             |
| `↑` / `Ctrl-p`   | Move selection up           |
| `↓` / `Ctrl-n`   | Move selection down         |
| `Enter`          | Confirm the selection       |
| `Esc` / `Ctrl-c` | Cancel and close the picker |

### 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 `.`).

<Note>
  Press `Space F` (uppercase) to include dotfiles such as `.env` and `.github/` in the list. `.gitignore` rules still apply.
</Note>

### 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.

### Workspace search

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

| Binding   | Scope                                   |
| --------- | --------------------------------------- |
| `Space d` | Diagnostics in the current buffer       |
| `Space D` | Diagnostics across the entire workspace |

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](/editing/navigation#jumplist).

### 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](/editing/navigation#bookmarks).