In-editor support for authoring Poliglot matrices — diagnostics, hover, go-to-definition, and completion for the Turtle (.ttl) and SPARQL (.rq) files that define a matrix.
A matrix is a composable specification of your operating model — its capabilities, policies, and rules. This extension is a thin Language Server Protocol client; all language intelligence lives in the plgt CLI's plgt lsp server, which the extension launches on activation.
Status: alpha. Poliglot is in private beta.
What you get
- Diagnostics on
.ttland.rqfiles: predicate hallucination, namespace violations, dangling cross-references, SHACL violations,script://resolution errors. Same checks asplgt validate. - Hover on any prefixed name → shows
rdfs:label, definition, type, and where it's defined. - Go to definition → jumps to the file:line where a term is declared (local matrix or any installed dependency).
- Completion on
prefix:→ all terms in that namespace.
Requirements
- The
plgtCLI must be installed and onPATH. The extension launchesplgt lspas its server. - Your project must be initialized: a
poliglot.ymlat the workspace root, dependencies installed viaplgt install.
Configuration
| Setting | Default | Description |
|---|---|---|
plgt.serverCommand |
plgt |
Command used to launch the CLI. Set if the binary isn't named plgt or isn't on PATH. The extension invokes <command> lsp. Machine-scoped so a committed workspace .vscode/settings.json cannot point this at an arbitrary binary. |
Building from source
npm install
npm run bundle # esbuild bundle
npm run package # produces a .vsix
Install the resulting .vsix via the VS Code "Install from VSIX..." command in the Extensions view.
Development
npm install
npm run watch # esbuild --watch
npm run typecheck # tsc --noEmit
npm run lint
JetBrains and other editors
JetBrains IDEs (IntelliJ IDEA, PyCharm, GoLand, etc.) support LSP through the official LSP plugin. Point it at plgt lsp and register .ttl / .rq as the file types. A first-class JetBrains plugin is future work.
Documentation
- IDE reference: https://poliglot.io/docs/ide/vscode
- Full docs: https://poliglot.io/docs
Contributing
See CONTRIBUTING.md. All contributors must sign the Poliglot Contributor License Agreement before their first PR is merged.
Bugs and feature requests go through GitHub Issues; security issues use private security advisories — see SECURITY.md.
License
Apache License 2.0 · © Poliglot Inc.