Auto-completion¶
As you type, a popup offers completions for the current word. Suggestions are file-format aware and come from several sources, merged into one ranked, de-duplicated list:
- Language keywords — the keyword and identifier lists of the file's
detected language (C++ keywords in a
.cpp, Python builtins in a.py). - Words from open files — every word already present in your open
buffers, so your own names (
calculateTotal,myVar) complete after their first use, across tabs. - Snippets — snippet prefixes appear in the list with a marker glyph; accepting one expands the snippet immediately.
- Language servers — when an LSP server is running for the file's language, its semantic completions join the list.
Using the popup¶
| Action | Key |
|---|---|
| Trigger manually | Ctrl+Space |
| Accept the highlighted suggestion | Tab or Enter |
| Dismiss | Esc |
The popup also opens automatically once you have typed enough word characters (default 2 — configurable). It keeps filtering as you type and closes on its own when nothing matches.
Settings¶
Preferences ▸ Auto-Completion:
| Setting | Default | Meaning |
|---|---|---|
| Enable auto-completion | on | Turn automatic popups off (manual Ctrl+Space still works). |
| Show after typing N characters | 2 | Minimum prefix length before the popup opens automatically. |
| Case-insensitive matching | on | pri also matches Print. |
| Insert a single match without showing the list | off | When exactly one suggestion remains, insert it silently instead of showing a 1-item popup. |
| Visible rows in the popup | — | Height of the list before it scrolls. |
| Maximum suggestions | — | Hard cap on the merged list. |
| Language keywords | on | Toggle the keyword source. |
| Words from open files | on | Toggle the open-buffers source. |
Very large files skip automatic completion (the same size gate that protects syntax colouring), so typing never stalls.
Related¶
- Snippets — Tab-expandable snippets that ride the same popup.
- LSP (Language Server) — semantic, project-aware completions.
- Auto-pair & indentation — the other as-you-type helpers.