Install

oxabl is one binary, oxabl. It’s published on crates.io, and you install it with Cargo, Rust’s package manager. There are no prebuilt downloads yet.

Before you start

You need Rust and Cargo. If cargo --version doesn’t print a version, install them from rustup.rs. rustup puts Cargo’s binaries in ~/.cargo/bin and adds that directory to your PATH.

oxabl’s own CI builds and tests it on Linux. Windows and macOS builds aren’t tested in CI yet.

Install oxabl

cargo install oxabl --locked

Cargo downloads the source and compiles it with about 140 dependencies, so the first install takes a while. --locked builds with the exact dependency versions the release was tested with. The last line names the version:

   Installed package `oxabl v3.0.2` (executable `oxabl`)

Check that it runs

oxabl --help

High-performance tooling for Progress ABL

Usage: oxabl <COMMAND>

Commands:
  check    Lint ABL source and report formatting drift — the one pre-commit gate
  explain  Show direct database effects and transitive summaries of each unit
  format   Format ABL source: fix layout (indentation, blank-line runs, comment placement) in place, or check/print without writing
  lsp      Run the language server over stdio (LSP), publishing live diagnostics
  schema   Emit the JSON Schema for `oxabl.toml` to stdout
  help     Print this message or the help of the given subcommand(s)

Options:
  -h, --help  Print help

oxabl has no --version flag yet. Cargo knows which version it installed:

cargo install --list

oxabl v3.0.2:
    oxabl

Update

Run the install command again. Cargo replaces oxabl when crates.io has a newer release, and otherwise leaves it alone:

     Ignored package `oxabl v3.0.2` is already installed, use --force to override

Remove

cargo uninstall oxabl

Quick start: check and format a project in five minutes.