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.
-
Run the installer:
Terminal window curl -fsSL https://raw.githubusercontent.com/oxidean/oxl/main/scripts/install.sh | shPin a specific release with
sh -s -- v0.9.0appended. -
Put the shim on
PATH— the installer prints this line:Terminal window export PATH="$HOME/.oxl/bin:$PATH" -
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 version manager
Section titled “The version manager”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:
$OXL_TOOLCHAIN— explicit one-command override.oxl-version— a dotfile pin (walking up from the cwd)toolchain vX.Y.Zin the nearestoxl.mod— the project’s pin~/.oxl/default-version— the fallback
oxl toolchain install v0.9.0 # download + verify + unpackoxl toolchain list # installed versionsoxl toolchain use v0.9.0 # set the defaultoxl toolchain default # print the default tagoxl toolchain use --local v0.9.0 # pin a directory (.oxl-version)oxl toolchain current # resolved tag + its sourceA 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.
Building from source
Section titled “Building from source”For development work on oxl itself, or platforms without a prebuilt tarball:
git clone https://github.com/oxidean/oxl && cd oxlbash scripts/stage0.sh # stage-0 snapshot -> target/oxlexport 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.