QQL — Qdrant Query Language for VS Code

A full IDE experience for QQL — syntax highlighting, live linting, hover plans, outline, CodeLens, REST compile, curl export, and smart completions.

QQL is to Qdrant what SQL is to Postgres.

Features

Language support (QQL 1.5 / Qdrant 1.19)

Highlights and completions cover the full QQL 1.5 surface, including:

Syntax Highlighting

The generated TextMate grammar highlights QQL keywords, constants, strings, numbers, comments, parameter placeholders (:name, ?), comparison operators, formula variables ($score), and dotted paths (field.nested, items[].name).

Also injects into Markdown fenced blocks:

```qql
QUERY TEXT 'hello' FROM docs USING dense LIMIT 10;
```

Live Diagnostics

Every .qql file is parsed in real time by the same WASM build of qql-core. Parse errors appear as red squiggles with the exact error code, message, and span from the Rust pipeline.

• Updates within ~300ms of typing (configurable)
• Byte-accurate spans (UTF-8 → UTF-16 conversion)
• Zero network — the WASM binary is bundled

Hover Intelligence

• Keyword docs for statements, modes, clauses, filters, formula helpers
• Live plan for the enclosing statement (intent, collection, CTEs, limit)
• REST route summary when the statement compiles (POST /collections/…/points/query)

Outline & Folding

• Outline / breadcrumbs list every top-level statement with kind + collection
• CTE children nest under WITH queries
• Folding for multi-line statements, parenthesized regions, and comment blocks
• Region markers: -- #region / -- #endregion

CodeLens

Above each statement:

Disable with qql.codeLens.enabled.

Commands

Also available from the editor title bar and right-click QQL submenu.

Status Bar

Shows ✓ QQL N when valid, or ✗ QQL with the error code on failure. Click to re-analyze.

Go to Definition

Jump from a CTE reference in PREFETCH (…) back to its name AS ( definition.

Smart Completions

• Contextual follow-ups — after QUERY suggest modes; after FUSION suggest RRF/DBSF; after TYPE suggest index types; …
• Collection names harvested from the current file
• CTE names suggested inside PREFETCH
• Snippets for hybrid, CTE fusion, rerank, recommend, DDL, shards, quotas, MATCH PREFIX, SLICE, memory placement, …
• Full keyword list still available for filter-as-you-type

Snippet prefixes (Insert Snippet): qnearest, qhybrid, qcte, qcreate, qcreatemem, qupsert, qcross, qcount, qrecommend, qquota, qsetquota, qprefix, qslice.

Language Ergonomics

• Comment toggle (Ctrl+/ → -- )
• Bracket colorization + auto-close for {} [] ()
• Smart indent on open parens/braces
• Continue -- comments on Enter

Settings

How It Works

.qql file
    │
    ▼ (debounced)
 AnalysisService  ── qql-wasm analyze()
    │                     │
    │              ┌──────┴──────┐
    │              │ Rust WASM   │
    │              │ lexer/parse │
    │              │ plan/route  │
    │              └──────┬──────┘
    │                     │
    ├── Diagnostics (errors)
    ├── Status bar (valid / N stmts)
    ├── CodeLens (Explain · REST · curl)
    ├── Outline symbols + CTE children
    ├── Hover (keyword docs + plan)
    └── Completions (context + collections)

Commands (explain, compile, curl, AST) call the same WASM surface (explain, compile, parse, analyze).

• No network for editing features
• No language server process — everything runs in the extension host

Requirements

• VS Code 1.85+
• No extra runtime deps — WASM is bundled

Installation

Marketplace

code --install-extension srimon12.qql-lang

From .vsix (local / GitHub Release)

VSIX binaries are not committed to the repo. Build one locally or download from GitHub Releases.

code --install-extension qql-lang-*.vsix --force

Extension packaging version is in package.json (0.2.4). It ships the QQL 0.2.1 WASM parser from this monorepo (crate version need not match the VSIX version). Note: the checked-in WASM binary may still reflect a pre-1.4 parse surface until rebuilt with wasm-pack; TextMate / keyword artifacts stay in sync with QQL 1.4 via qql-grammar-gen generate without a WASM rebuild.

Build from source

git clone https://github.com/srimon12/qql-rs
cd qql-rs/editors/vscode

# Build the WASM parser (Node target)
wasm-pack build ../../crates/qql-wasm --release --target nodejs --out-dir wasm

npm install
npm run check
npm run compile
npm run package          # npx @vscode/vsce package → qql-lang-<version>.vsix
code --install-extension qql-lang-*.vsix --force

Related Projects

License

MIT — see LICENSE for details.