◍ Downloads

Every release binary, with checksums. If you just want it installed, the one-line installers do this for you.

Current release: v0.17.1. Binaries are hosted on GitHub Releases. They are unsigned — verify the SHA-256 below before running, especially on a machine you did not build them on.

Binaries

Platform	File	Size
macOS · Apple Silicon	oam-aarch64-apple-darwin	60.9 MB
macOS · Intel	oam-x86_64-apple-darwin	63.2 MB
Windows · ARM64	oam-aarch64-pc-windows-msvc.exe	61.5 MB
Windows · x64	oam-x86_64-pc-windows-msvc.exe	67.1 MB
Linux · x64 (glibc)	oam-x86_64-unknown-linux-gnu	69.2 MB

No linux-arm64 build yet: it compiles, but the V8 startup snapshot cannot be cross-compiled, so it needs a native ARM builder. SHA256SUMS, LICENSE, NOTICE and THIRD_PARTY_LICENSES.md ship with every release.

SHA256SUMS (v0.17.1)

4ba5a291d800618cda07ce42ac1c7fbc5841db941a22d328fb87534b3055b521 *oam-aarch64-apple-darwin
039dccb29f7784cdc92b6165f7990650b3f82fceb4e77067a7bc4ba159083a73 *oam-aarch64-pc-windows-msvc.exe
7ebdb580b5fa7b8c1108b5deb454812a0bc0e6b1da7ae60a37622805d8e92a72 *oam-x86_64-apple-darwin
68eba2eed03a83b70428fdc49e28774eb998637600ce9238eac7d30c7da06c1a *oam-x86_64-pc-windows-msvc.exe
9140fa0eabde83eef13c02aed871dbd2ea852f7283e238115c01ca4c57f21298 *oam-x86_64-unknown-linux-gnu

Verify

macOS and Linux — check every file the release published:

curl -fsSLO https://github.com/YawLabs/oam/releases/download/v0.17.1/SHA256SUMS
shasum -a 256 -c SHA256SUMS --ignore-missing

Or a single file, compared against the line above:

shasum -a 256 oam-aarch64-apple-darwin

Windows (PowerShell):

Get-FileHash .\oam-aarch64-pc-windows-msvc.exe -Algorithm SHA256 | Format-List

Get-FileHash prints uppercase; the sums above are lowercase. Compare case-insensitively, or pipe through .Hash.ToLower().

After downloading

The file is the whole runtime — there is nothing to unpack. On macOS and Linux mark it executable and put it on your PATH:

chmod +x oam-aarch64-apple-darwin
mv oam-aarch64-apple-darwin ~/.local/bin/oam
oam --version

macOS quarantines files downloaded by a browser, and these are unsigned, so Gatekeeper will refuse the first run. Clear the attribute:

xattr -d com.apple.quarantine ~/.local/bin/oam

Installing a specific version

The installers take OAM_VERSION — a release tag, including the v. Unset, they resolve the latest release.

macOS and Linux:

curl -fsSL https://oamjs.org/install.sh | OAM_VERSION=v0.17.1 sh

The variable has to be on sh, not on curl — curl is a different process and would not pass it along.

Windows:

$env:OAM_VERSION = "v0.17.1"; irm https://oamjs.org/install.ps1 | iex

Two related knobs: OAM_INSTALL_DIR changes the target (default ~/.oam/bin, or %LOCALAPPDATA%\oam\bin), and OAM_INSTALL_BASE points at a mirror instead of GitHub Releases. Whatever the source, the installer still verifies against the published SHA256SUMS and refuses a mismatch.

An existing install updates itself with oam self-update, which re-runs this installer and performs the same verification.

All releases

Older versions, with notes and their own checksums, are on the releases page.