Editors

VS Code extension

The official extension is qql-lang (publisher srimon12), displayed as "QQL — Qdrant Query Language". It is published on the Visual Studio Code marketplace and is also bundled as a local VSIX in the repository at editors/vscode/qql-lang-0.2.0.vsix.

Install from the marketplace

code --install-extension srimon12.qql-lang

Or install the local VSIX manually:

1. Open the Extensions panel (Ctrl+Shift+X).
2. Open the ⋯ (More Actions) menu.
3. Choose Install from VSIX... and select editors/vscode/qql-lang-0.2.0.vsix.

Requirements

Requires VS Code 1.85 or newer. The extension is fully offline: live diagnostics run on a bundled qql-wasm parser, and no network access or external language runtime is needed.

Syntax highlighting

The TextMate grammar highlights .qql files with 130+ keywords across 8 scopes, covering statements, operators, punctuation, strings, and comments. The same grammar powers the syntax highlighting on this website.

Live diagnostics

The extension runs the bundled qql-wasm parser on every change, debounced at ~300 ms, and reports grammar errors with precise spans and stable error codes. Invalid statements are underlined directly in the editor.

Autocompletion

Completions cover 130+ keywords and 28 statement snippet templates, including:

• QUERY NEAREST / QUERY HYBRID / QUERY HYBRID DBSF
• CTE + FUSION and CTE + RERANK
• QUERY RECOMMEND, QUERY MMR, QUERY FORMULA
• QUERY POINTS, QUERY ORDER BY, QUERY SAMPLE
• UPSERT INTO, CREATE COLLECTION, CREATE INDEX
• SCROLL, COUNT, COUNT EXACT, DELETE, DELETE PAYLOAD

Language configuration

The extension ships a standard VS Code language configuration: Ctrl+/ toggles -- line comments, brackets {} [] () are matched and auto-closed, and single and double quotes auto-close as well.