Skip to content

Install

Requires: a C compiler (cc) and pthreads; oxl build/run emit C and link through it. Prebuilt tarballs ship for Linux (x86_64) — macOS (aarch64) and Windows (x86_64, via MinGW gcc or LLVM clang) build from source.

  1. Run the installer:

    Terminal window
    curl -fsSL https://raw.githubusercontent.com/oxidean/oxl/main/scripts/install.sh | sh

    Pin a specific release with sh -s -- v0.9.0 appended.

  2. Put the shim on PATH — the installer prints this line:

    Terminal window
    export PATH="$HOME/.oxl/bin:$PATH"
  3. Verify:

    Terminal window
    oxl version # → oxl v0.9.0 (language 0.3)

When the release publishes a sidecar, the installer verifies the download against its .sha256 using sha256sum, shasum, or openssl — first found on PATH — and latest resolves the newest toolchain release: an extra/v* extras release never shadows it.

The oxl on PATH is a dispatch shim — multiple toolchains live side by side under ~/.oxl/versions/, and the shim picks one per command, first hit wins:

  1. $OXL_TOOLCHAIN — explicit one-command override
  2. .oxl-version — a dotfile pin (walking up from the cwd)
  3. toolchain vX.Y.Z in the nearest oxl.mod — the project’s pin
  4. ~/.oxl/default-version — the fallback
Terminal window
oxl toolchain install v0.9.0 # download + verify + unpack
oxl toolchain list # installed versions
oxl toolchain use v0.9.0 # set the default
oxl toolchain default # print the default tag
oxl toolchain use --local v0.9.0 # pin a directory (.oxl-version)
oxl toolchain current # resolved tag + its source

A resolved-but-missing toolchain exits with the install command that fixes it — nothing is auto-downloaded mid-build.

oxl toolchain verbs live in the shim — a source-built oxl binary answers unknown command; only release installs under ~/.oxl are managed.

For development work on oxl itself, or platforms without a prebuilt tarball:

Terminal window
git clone https://github.com/oxidean/oxl && cd oxl
bash scripts/stage0.sh # stage-0 snapshot -> target/oxl
export PATH="$PWD/target:$PATH"

A source-built binary reports oxl dev (language 0.3). The version manager only manages release installs; keep a dev build earlier on PATH when you want it to win.