Install the Strixonomy CLI (macOS and Windows)¶
Canonical install: Install. Most users never need this page. The Strixonomy VS Code / Cursor extension bundles
strixonomy-lsp. Install the extension for IDE work and skip compiling the CLI unless you needstrixonomyfor CI, scripting, or local validation outside the editor.
Release CLI tarballs are Linux x64 only (x86_64-unknown-linux-gnu). On macOS and Windows, install from crates.io with Rust. On Linux arm64 (and other non-x64 targets), there is no tarball — use cargo install below or the LSP bundled in the VSIX (platform compatibility).
Canonical pin: 0.27.0 (TAGGED_RELEASE). See also Install CLI & CI (detail) and CI integration (Linux CI prefers the release tarball).
Prerequisites¶
| Requirement | macOS | Windows |
|---|---|---|
| Rust toolchain | 1.88+ via rustup | 1.88+ via rustup |
| System tools | Xcode Command Line Tools: xcode-select --install | MSVC Build Tools (C++ workload) |
| Disk / time | Expect 15–30+ minutes cold compile and several GB for cargo cache | Same |
Apple Silicon notes¶
- Install the aarch64 Rust toolchain via rustup on Apple Silicon Macs (default on current macOS).
- Ensure
~/.cargo/binis on yourPATH(rustup installer usually configures this).
Verify tools¶
rustc --version # 1.88 or newer
cargo --version
macOS:
xcode-select -p # should print a Developer path
Install¶
cargo install strixonomy-cli --locked --version 0.27.0
export PATH="$HOME/.cargo/bin:$PATH"
strixonomy --help
which strixonomy # typically ~/.cargo/bin/strixonomy
cargo install strixonomy-cli --locked --version 0.27.0
$env:Path += ";$env:USERPROFILE\.cargo\bin"
strixonomy --help
Get-Command strixonomy
Persist PATH via Settings → System → Environment Variables (User Path → add %USERPROFILE%\.cargo\bin) if the shell cannot find strixonomy after restart.
Wrong crate name
The GitHub repo is strixonomy. The crate and CLI are strixonomy-cli / strixonomy. Do not run cargo install strixonomy.
First commands¶
Use your ontology directory (there is no fixtures/ outside a git clone):
strixonomy validate /path/to/your/ontologies
strixonomy query /path/to/your/ontologies "SELECT * FROM classes"
When to use the extension instead¶
| Goal | Prefer |
|---|---|
| Browse / edit in the IDE | VS Code extension |
| Local CI-like validate/query without VS Code | This CLI install |
| Linux CI in GitHub Actions | Release tarball (faster than compile) |
Custom strixonomy.lspPath without compiling | Prebuilt strixonomy-lsp-* archives on GitHub Releases (macOS, Windows, Linux x64/arm64) — set strixonomy.lspPath to the extracted binary (trusted workspace) |
Optional: prebuilt language server (skip cargo install for LSP)¶
Release assets include platform-specific strixonomy-lsp binaries (for example strixonomy-lsp-*-apple-darwin.tar.gz, strixonomy-lsp-*-pc-windows-msvc.zip, Linux gnu/musl and arm64 variants). Download, verify against SHA256SUMS, extract, and point strixonomy.lspPath at the binary. Most users should keep the bundled LSP from the VSIX and skip this.
Troubleshooting¶
| Problem | What to try |
|---|---|
strixonomy: command not found | Add ~/.cargo/bin to PATH; open a new terminal |
| Compile errors on Windows | Install MSVC Build Tools with the C++ desktop workload |
| Compile errors on macOS | Re-run xcode-select --install; update Xcode CLT |
| Wrong version after install | Re-run with --version 0.27.0 --locked; check strixonomy --version |
| Slow installs | Expected on first cold build; subsequent upgrades are faster |