Install Strixonomy¶
Canonical install page. Most users only need the Strixonomy IDE (VS Code/Cursor extension). The Strixonomy engine CLI is optional (CI / scripting).
| Goal | Go here |
|---|---|
| Edit ontologies in VS Code / Cursor | Install the extension → First success (~10 min) |
| Optional CLI on macOS / Windows | Install CLI (cargo) · detail: macOS/Windows walkthrough |
| CI validate on Linux x64 | CI with release tarball |
| Which binary / crate do I need? | Which artifact? |
| Product names (IDE vs engine) | Product identity |
Most IDE users never need Rust
The Strixonomy IDE bundles strixonomy-lsp. Install the extension and skip the CLI unless you need strixonomy for CI, scripting, or validation outside the editor.
Wrong cargo package
Install the CLI with cargo install strixonomy-cli (binary name: strixonomy). cargo install strixonomy installs the library crate, not the CLI.
Canonical pin: 0.27.0 (TAGGED_RELEASE). Channel lag (Marketplace vs crates.io vs docs): Versions & channels.
1. VS Code / Cursor extension (recommended)¶
| Method | Platforms | Needs Rust? |
|---|---|---|
| Marketplace / Open VSX | Linux, macOS, Windows | No |
Release VSIX (strixonomy-v0.27.0.vsix) | Same | No |
- Install Strixonomy (
strixonomy.strixonomy). - If the store lags the latest GitHub tag, install the VSIX — Marketplace lag playbook.
- Open a folder of
.ttl/.obo/.owl/.rdf/.owxfiles. - Open the Strixonomy activity bar.
Full steps (Trust, offline, custom lspPath): VS Code install details.
Next: First success (~10 min).
2. Optional CLI¶
| Method | Linux x64 | macOS | Windows | Needs Rust? |
|---|---|---|---|---|
cargo install strixonomy-cli --locked --version 0.27.0 | Yes | Yes | Yes | Yes (1.88+) |
| Release CLI tarball | Yes | No | No | No |
Git clone + cargo run -- | Yes | Yes | Yes | Yes (1.88+) |
Cold compile
First cargo install often takes 15–30+ minutes. Prefer the Linux x64 tarball for CI — CI integration.
cargo install (macOS / Windows / any platform)¶
Prerequisites: Rust 1.88+; Windows needs MSVC Build Tools; macOS needs Xcode CLT (xcode-select --install).
cargo install strixonomy-cli --locked --version 0.27.0
export PATH="$HOME/.cargo/bin:$PATH"
strixonomy validate /path/to/your/ontologies
Longer macOS/Windows walkthrough: Install CLI.
Linux x64 release tarball (CI preferred)¶
See CI integration — download strixonomy-v0.27.0-x86_64-unknown-linux-gnu.tar.gz, verify SHA256SUMS, run validate / classify.
From a clone¶
git clone https://github.com/eddiethedean/strixonomy.git
cd strixonomy
cargo run -- validate fixtures
3. What you can edit¶
Write-back: .ttl, .obo, .owl/.rdf, .owx. XML is semantic re-serialize (not Protégé byte-identical). JSON-LD / N-Triples / TriG stay read-only — Supported formats · Capabilities by format.
Related¶
| Topic | Doc |
|---|---|
| Full CLI / CI install matrix (all paths) | Install CLI & CI (detail) |
| VS Code options (offline, Restricted Mode) | vscode-install.md |
| Release integrity | release-integrity.md |
| Platform support | platform-compatibility.md |
| Air-gap artifact filenames | Versions & channels |