Repolode
Submit
minad

minad/vertico

A minimalist vertical completion UI for Emacs that builds on the built-in completion system and works with its completion commands.

View on GitHub
Stars
1,896
Forks
76
Open issues
0
Last commit
27 days ago

What is it?

Vertico is a completion UI for Emacs minibuffer prompts that displays candidates in a vertical list. It reuses Emacs' built-in completion facilities rather than defining its own API, so commands and completion tables that already work with completing-read behave the same way under Vertico.

The package provides arrow-key navigation, candidate insertion with TAB, selection with RET, and the option to submit input that isn't in the candidate list with M-RET. Candidates can be sorted by history, frequency, length, or alphabetically, and grouping, annotations and affixations are supported. Optional extensions add flat, grid, reverse, buffer-based and other display modes, plus per-command configuration through vertico-multiform.

Vertico only provides the UI and is designed to be combined with companion packages such as Orderless for matching, Marginalia for annotations, Consult for search and navigation commands, and Embark for actions on candidates.

Key features

  • 01Vertical candidate list with arrow-key navigation and a candidate index in the prompt.
  • 02Built on Emacs' built-in completion, so existing completion commands remain compatible.
  • 03Sorting by history, frequency, length, or alphabetically.
  • 04Extensions for flat, grid, reverse, buffer and other display modes.
  • 05Per-command and per-category display configuration via vertico-multiform.

Use cases

  • Choosing files, buffers, or commands in Emacs through a vertical completion list.
  • Pairing with Orderless and Consult for flexible search and navigation in the minibuffer.
  • Replacing Ivy, Helm-style completion with a smaller, more composable setup.

Quick start

  1. 1

    Install Vertico from ELPA or MELPA with package-install

    M-x package-install RET vertico RET
  2. 2

    Activate the global minor mode

    M-x vertico-mode RET

Things to know

  • Emacs-only: it is an Emacs Lisp package for the Emacs editor.

Topics

#emacs#emacs-lisp#completion#minibuffer#editor#text-editor

FAQ

What is vertico?
A minimalist vertical completion UI for Emacs that builds on the built-in completion system and works with its completion commands. Vertico is a completion UI for Emacs minibuffer prompts that displays candidates in a vertical list. It reuses Emacs' built-in completion facilities rather than defining its own API, so commands and completion tables that already work with completing-read behave the same way under Vertico.
Is vertico free to use? What license does it have?
vertico is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.
Is vertico still maintained?
Actively maintained. The last commit to vertico was on Oct 11, 2026.
What can I use vertico for?
Choosing files, buffers, or commands in Emacs through a vertical completion list. Pairing with Orderless and Consult for flexible search and navigation in the minibuffer. Replacing Ivy, Helm-style completion with a smaller, more composable setup.
How do I install vertico?
Install Vertico from ELPA or MELPA with package-install: M-x package-install RET vertico RET Activate the global minor mode: M-x vertico-mode RET
Where can I get vertico?
The source code and installation instructions are on GitHub: https://github.com/minad/vertico

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects

minad / corfu

Corfu is a minimalist in-buffer completion popup for Emacs that reuses Emacs' built-in completion-at-point facilities.

Developer Tools#emacs#completion#editor
1.6K59Emacs LispGPL-3.0Updated 5 days ago