Install the CLI

The CLI ships as a single self-contained executable. It bundles its own runtime, so there is nothing to install alongside it — no Deno, no Node, no package manager.

Quick install

macOS / Linux

curl -fsSL https://docs.polymesa.com/install.sh | sh

The script detects your OS and architecture, downloads the matching binary, verifies its SHA-256 checksum, and installs to /usr/local/bin/polymesa.

To install somewhere else — useful when you do not want to use sudo:

curl -fsSL https://docs.polymesa.com/install.sh | POLYMESA_INSTALL_DIR="$HOME/.local/bin" sh

Windows

irm https://docs.polymesa.com/install.ps1 | iex

Installs to %LOCALAPPDATA%\Polymesa\bin and adds it to your user PATH. Open a new terminal afterwards so the updated PATH takes effect.

Piping to a shell

Piping a script straight into sh runs remote code on your machine. If you would rather read it first, download it, inspect it, then run it — the script is plain POSIX shell and roughly 60 lines.

Direct downloads

Grab a binary yourself if you prefer, or if you are pinning a version in CI.

macOS · Apple siliconaarch64-apple-darwinmacOS · Intelx86_64-apple-darwinLinux · x86_64x86_64-unknown-linux-gnuLinux · ARM64aarch64-unknown-linux-gnuWindows · x86_64x86_64-pc-windows-msvc.exe

Every release also publishes checksums.txt alongside the binaries, and https://dl.polymesa.com/cli/versions.json lists all available versions.

After downloading manually, mark it executable and put it on your PATH:

chmod +x polymesa-aarch64-apple-darwin
sudo mv polymesa-aarch64-apple-darwin /usr/local/bin/polymesa

Pinning a version

latest always points at the newest release. To pin, swap it for a version number:

curl -fsSLO https://dl.polymesa.com/cli/1.0.0/polymesa-x86_64-unknown-linux-gnu

macOS Gatekeeper

The binaries are not notarized yet, so macOS will refuse to run a manually downloaded one on first launch. Clear the quarantine attribute:

xattr -d com.apple.quarantine /usr/local/bin/polymesa

The install.sh path does this for you.

Verify

polymesa --version
polymesa --help

Build from source

If you have the repository and a Deno toolchain, you can compile it yourself:

cd cli
deno task install

That installs a polymesa shim onto your PATH that runs from source — handy while developing the CLI itself, since edits take effect without recompiling.

To produce a standalone binary instead:

deno compile \
  --allow-read --allow-write --allow-net --allow-env \
  --allow-run=open,xdg-open,cmd \
  --output polymesa \
  cli/main.ts

Next steps

Authenticate, then deploy something:

• Authentication — log in and store credentials
• Command reference — every command and flag