CLI & package managers

Use these methods when you want the basilisk binary on its own — for the command line, for CI, or to back an editor that talks to a system install. Basilisk is a single Rust binary with no runtime dependencies: no Node.js, no Python interpreter, no package manager required after installation.

Using VS Code, Cursor, or Windsurf? The binary is bundled in the extension — see VS Code & Cursor. Using Zed? The binary downloads with the extension — see Zed. Neither needs a separate CLI install.

Homebrew (macOS, Linux)

brew tap Nimblesite/tap
brew install basilisk

Installs the latest released basilisk binary on macOS (Apple Silicon) and Linux (x86_64, aarch64). Upgrade with brew upgrade basilisk.

Scoop (Windows)

scoop bucket add nimblesite https://github.com/Nimblesite/scoop-bucket
scoop install basilisk

Installs the latest released basilisk.exe on Windows (x86_64 and arm64). Upgrade with scoop update basilisk.

Pre-built binaries

Download the latest release for your platform from GitHub Releases:

# macOS (Apple Silicon)
curl -sSfL -o basilisk.zip https://github.com/Nimblesite/Basilisk/releases/latest/download/basilisk-aarch64-apple-darwin.zip
unzip basilisk.zip && sudo mv basilisk-darwin/basilisk /usr/local/bin/

# Linux (x86_64)
curl -sSfL https://github.com/Nimblesite/Basilisk/releases/latest/download/basilisk-x86_64-unknown-linux-gnu.tar.gz | tar xz
sudo mv basilisk /usr/local/bin/

# Linux (aarch64)
curl -sSfL https://github.com/Nimblesite/Basilisk/releases/latest/download/basilisk-aarch64-unknown-linux-gnu.tar.gz | tar xz
sudo mv basilisk /usr/local/bin/

Verify the installation:

basilisk --version

Build from source

git clone https://github.com/Nimblesite/Basilisk
cd Basilisk
cargo build --release

The binary is built at target/release/basilisk. Add it to your PATH:

cp target/release/basilisk /usr/local/bin/

Rust 1.87+ required.

CI integration

Basilisk integrates naturally into any CI pipeline. Download the binary in your workflow:

# GitHub Actions example
- name: Install Basilisk
  run: |
    curl -sSfL https://github.com/Nimblesite/Basilisk/releases/latest/download/basilisk-x86_64-unknown-linux-gnu.tar.gz | tar xz
    sudo mv basilisk /usr/local/bin/

- name: Type check
  run: basilisk check src/

Exit codes:

  • 0 — No errors found
  • 1 — Type errors found
  • 2 — Configuration error
  • 3 — Internal error