Canonical install: Install (SSOT). This page covers VS Code–specific options (Marketplace, VSIX, Restricted Mode, custom lspPath). Artifact filenames: Versions & channels — air-gap manifest.

Installing Strixonomy in VS Code¶

Primary path: Marketplace (or Open VSX for Cursor) → First success (~10 min).

Multi-root workspaces (v0.10+): All workspace folders are indexed on open. Strixonomy: Index Workspace may prompt you to pick a folder when multiple roots are open.

Prerequisites¶

• VS Code 1.85+ (see platform compatibility)
• Strixonomy’s bundled language server runs in trusted and Restricted Mode. Do not Trust the workspace unless you configured strixonomy.lspPath or strixonomy.robotPath — those settings are ignored when the folder is untrusted.

Install matrix¶

CLI install options (separate from the extension): Install · Install CLI & CI (detail).

Option A — VS Code Marketplace (recommended)¶

1. Install Strixonomy from the Marketplace (or Open VSX for Cursor). If the store lags the latest GitHub tag, use the VSIX under Option B — see Versions and channels.
2. File → Open Folder… and choose a directory with ontology files.
3. Strixonomy’s bundled language server runs without Trust; do not Trust unless you need custom strixonomy.lspPath / strixonomy.robotPath.
4. Open the Strixonomy activity bar and browse ontologies, classes, properties, individuals, and Diagnostics.

For a full walkthrough, see First success in 10 minutes.

Sample ontology files: prefer the curl/PowerShell commands in First success. Offline: download strixonomy-tutorial.zip from the v0.27.0 GitHub Release, unzip, and open that folder — or open fixtures/ from a clone.

Option B — GitHub Release VSIX (offline / air-gapped)¶

1. Open GitHub Releases and download the latest strixonomy-v*.vsix (example: strixonomy-v0.27.0.vsix).
2. In VS Code: Extensions → … menu → Install from VSIX…
3. Verify against SHA256SUMS — see release-integrity.md.
4. Open a folder containing ontology files (.ttl, .obo, .owl, .rdf, .owx editable; .jsonld, .nt, .nq, .trig browse/query only).

Release VSIX packages bundle strixonomy-lsp for Linux, macOS, and Windows.

Option C — Build from source¶

Prerequisites: Rust 1.88+, Node 20+, npm (see contributing.md).

From the repository root:

./scripts/package-extension.sh   # builds LSP + compiles extension (does not emit VSIX)
cd extension && npx vsce package --no-dependencies

Install the generated .vsix via Install from VSIX…, or press F5 in VS Code with the extension/ folder open (Run Extension).

Option D — Language server on PATH¶

Use this only when the bundled server is missing or you are developing the LSP:

cargo install strixonomy-lsp --locked --version 0.27.0

Set Strixonomy: Lsp Path (strixonomy.lspPath) to the absolute path of your strixonomy-lsp binary. Trusted workspaces only — ignored in Restricted Mode.

Option E — Cursor / Open VSX (v0.11+)¶

Cursor uses the Open VSX registry instead of the Microsoft VS Code Marketplace.

1. Open Extensions in Cursor and search for Strixonomy (publisher strixonomy).
2. Install Strixonomy (strixonomy.strixonomy).
3. Open a folder with ontology files. Strixonomy’s bundled language server works in trusted and Restricted Mode — do not Trust unless you configured strixonomy.lspPath or strixonomy.robotPath.

If Strixonomy does not appear in search (before v0.11 or if Open VSX sync is delayed):

1. Download strixonomy-v*.vsix (example: strixonomy-v0.27.0.vsix) from GitHub Releases.
2. Cmd+Shift+P / Ctrl+Shift+P → Extensions: Install from VSIX…

Release tags from v0.11.3 onward publish automatically to Open VSX.

Using the sidebar¶

After indexing, the Strixonomy activity bar shows five views:

Refresh — click ↻ on a view title, or run Strixonomy: Refresh Explorer.

Re-index — run Strixonomy: Index Workspace after adding or changing ontology files.

Click an entity name to open the Entity Inspector. For .ttl, .obo, .owl/.rdf, and .owx, use the edit section to change labels, parents, or delete entities (XML is semantic re-serialize). See authoring.md and OWL/XML write-back.

Settings¶

Indexing runs on workspace open. strixonomy.autoIndexOnOpen is a legacy setting (no-op); kept for compatibility.

Commands¶

• Strixonomy: Index Workspace — rebuild catalog
• Strixonomy: Refresh Explorer — refresh tree views (including diagnostics)
• Strixonomy: Open Query Workbench — SQL and SPARQL against indexed workspace (guide)
• Strixonomy: Open Manchester Editor / Add Manchester Axiom — complex class expressions (guide)
• Strixonomy: Run Reasoner — EL / RL / RDFS / DL / auto classification (guide)
• Strixonomy: Show Explanation — justification for unsatisfiable class
• Strixonomy: Set Hierarchy Mode — asserted / inferred / combined class tree
• Strixonomy: Open Class Graph / Property Graph / Import Graph / Neighborhood Graph — visualization (guide)
• Strixonomy: Create Class / Property / Individual — authoring in editable formats (richest on .ttl)
• Problems panel — inline diagnostics from strixonomy-lsp after indexing
• Strixonomy: Show Entity Inspector / Jump to Source — from explorer context menu

Troubleshooting¶

End users (Marketplace / Open VSX install)¶

Developers (building from source)¶

See Debugging guide for F5, webview-ui, and E2E workflows.

See also troubleshooting.md, faq.md, and First success in 10 minutes.