Install the Straddle CLI

Install straddle with a package manager or a release archive. Release binaries support x64 and ARM64 on macOS, Linux, and Windows.

Choose an installation method

Homebrew
npm
Shell installer
Release archive

On macOS, install from the Straddle tap:

brew install straddle-build/tap/straddle

With Node.js 18 or later, install the CLI globally:

npm install -g @straddlecom/cli

To try it without a global installation, run npx @straddlecom/cli --help. Keep npm’s optional dependencies enabled; they provide the binary for your platform.

On macOS or Linux, use the shell installer:

curl -fsSL https://raw.githubusercontent.com/straddle-build/straddle-cli/main/install.sh | sh

The installer downloads a release, verifies its SHA-256 checksum, and installs to ~/.local/bin. Set STRADDLE_INSTALL_DIR for the installer process to choose another directory.

Download the archive for your operating system and architecture from Straddle CLI releases. Compare its SHA-256 checksum with the release’s checksums.txt, then extract the binary into a directory on PATH.macOS release binaries are signed and notarized. Gatekeeper needs a network connection to check notarization on the first launch of a quarantined download.

Verify the command

Check the version and available commands:

straddle version
straddle --help

A version number and command list confirm that your shell can run the CLI. If the command isn’t found, add the installation directory to PATH and open a new terminal.

Connect your Straddle account

Configure credentials and context, then make a read request to confirm the API key works in the selected environment.

Install with Go

With a Go toolchain that meets the release’s module requirements, install from source:

go install github.com/straddle-build/straddle-cli/cmd/straddle@latest

Add your Go binary installation directory to PATH, then run straddle version.

Get started

Straddle Wizard

Agent skills

Playbooks

Straddle MCP

Straddle CLI

SDKs

Install the Straddle CLI