> ## 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: a Vim-style terminal editor that just works

> Vorto is a batteries-included, Vim-style modal terminal editor for the AI era — built-in LSP, tree-sitter highlighting, and GitHub Copilot in a single Rust binary, configured from one TOML file with no plugin manager or init script.

<Frame>
  <img src="https://mintcdn.com/sk-fe77f0a3/X05ZstP5HeDvHqx7/vorto.png?fit=max&auto=format&n=X05ZstP5HeDvHqx7&q=85&s=cd0b4b2008953bafdcf87cd3c1e6efa1" alt="Vorto" width="1536" height="1024" data-path="vorto.png" />
</Frame>

## The editor should be done

**If your current modal-editor config mostly exists to bolt on LSP, tree-sitter, fuzzy finding, and Copilot, Vorto replaces that whole stack with one binary.** No plugin manager, no per-plugin upgrade ritual, no morning where the LSP client and the tree-sitter runtime disagree about a breaking change. The editor either runs or it doesn't, and it updates atomically as a single binary. And in an AI-assisted workflow — where the editor works alongside a coding agent, a terminal, and a review loop — the hours that plugin upkeep used to justify are better spent shipping. Vorto leans into that: [`:agent`](/editing/agent) runs an AI coding agent in a pane right inside the editor.

For the philosophy behind these choices, see [Why Vorto](/why-vorto).

## Install

Vorto is a single static binary. Install it with [mise](https://mise.jdx.dev) or [Homebrew](https://brew.sh) (recommended) — both download a prebuilt binary with every built-in grammar embedded, so highlighting works on first launch:

<CodeGroup>
  ```bash mise theme={null}
  mise use github:vorto-editor/vorto
  ```

  ```bash Homebrew theme={null}
  brew install vorto-editor/tap/vorto
  ```
</CodeGroup>

You can also grab a prebuilt archive from the [releases page](https://github.com/vorto-editor/vorto/releases). A `cargo install vorto` build also works, but it ships without the bundled grammars and installs them on demand instead — see [Installation](/installation) for that and other options.

Then confirm the binary is on your `PATH`:

```bash theme={null}
vorto --version
```

That's enough to open your first file. For building from source and other options, see [Installation](/installation); to start editing, head to the [Quick start](/quickstart).

## Highlights

* **Batteries included.** The LSP client, tree-sitter engine, fuzzy finder, file explorer, themes, bookmarks, and Copilot integration all ship in the binary — no plugin manager, no init script, no `package.json`. Prebuilt binaries come with grammars for every built-in language baked in, and each language server installs once with a single command — Vorto wires them up automatically.
* **AI where you edit.** Copilot serves [inline ghost-text completions](/editing/copilot), and [`:agent`](/editing/agent) runs a coding agent — Claude, Codex, Gemini, or Aider — in a built-in pane, with `:agent explain @selection` handing it the code you've highlighted.
* **Vim commands, lower learning cost.** Vorto follows Vim's modal model, and surfaces [command hints inline](/editing/hints) so you don't have to keep the full keymap in your head. Pick it up faster; come back to it after a month without losing the muscle memory.
* **One config file.** Keybindings, themes, indentation, and per-language settings all live in a single TOML file. Nothing to bootstrap, nothing to migrate.

## Core concepts

**Modal editing.** Five modes (Normal, Insert, Visual, Visual Line, Visual Block) plus a `:` command prompt. The status bar always shows the active mode. See [Editing modes](/editing/modes).

**Language support.** 44 languages ship with built-in recipes. Prebuilt binaries embed their tree-sitter grammars, so highlighting works on first launch; `cargo` and source builds install grammars on demand via `vorto grammar install`. See [Supported languages](/languages/supported-languages).

**LSP client.** Diagnostics, completions, hover, code actions, and goto definition out of the box. Servers spawn lazily when you open a file. See [LSP overview](/lsp/overview).

**Configuration.** A single TOML file at `~/.config/vorto/config.toml` controls editor settings, keymaps, languages, and LSP servers. See [Configuration overview](/configuration/overview).

## Explore the docs

<CardGroup cols={2}>
  <Card title="Why Vorto" icon="circle-question" href="/why-vorto">
    The philosophy behind Vorto's batteries-included, single-binary design.
  </Card>

  <Card title="Installation" icon="download" href="/installation">
    Install Vorto from crates.io or build from source in minutes.
  </Card>

  <Card title="Quick start" icon="rocket" href="/quickstart">
    Open your first file, navigate in Normal mode, and start editing.
  </Card>

  <Card title="Editing modes" icon="keyboard" href="/editing/modes">
    Understand Normal, Insert, Visual, and Command mode in depth.
  </Card>

  <Card title="Language grammars" icon="tree" href="/languages/grammars">
    Install and manage tree-sitter grammars for syntax highlighting.
  </Card>

  <Card title="LSP client" icon="plug" href="/lsp/overview">
    Connect language servers for completions, diagnostics, and more.
  </Card>

  <Card title="AI agents" icon="robot" href="/editing/agent">
    Run Claude, Codex, Gemini, or Aider in a built-in pane with `:agent`.
  </Card>

  <Card title="Configuration" icon="sliders" href="/configuration/overview">
    Customize keybindings, themes, and language settings via TOML.
  </Card>
</CardGroup>