Installation

The Raterunner CLI can be installed on macOS, Linux, and Windows.

macOS

Homebrew

Homebrew is the recommended installation path for macOS.

bash

brew install raterunner/tap/raterunner

Manual download

Download the latest macOS release from GitHub Releases.

bash

# Apple Siliconcurl -sL https://github.com/raterunner/cli/releases/download/v0.0.1/raterunner_0.0.1_darwin_arm64.tar.gz | tar xzsudo mv raterunner /usr/local/bin/# Intelcurl -sL https://github.com/raterunner/cli/releases/download/v0.0.1/raterunner_0.0.1_darwin_amd64.tar.gz | tar xzsudo mv raterunner /usr/local/bin/

Linux

Debian and Ubuntu

bash

curl -sLO https://github.com/raterunner/cli/releases/download/v0.0.1/raterunner_0.0.1_linux_amd64.debsudo dpkg -i raterunner_0.0.1_linux_amd64.deb

RHEL, Fedora, and CentOS

bash

curl -sLO https://github.com/raterunner/cli/releases/download/v0.0.1/raterunner_0.0.1_linux_amd64.rpmsudo rpm -i raterunner_0.0.1_linux_amd64.rpm

Alpine

bash

curl -sLO https://github.com/raterunner/cli/releases/download/v0.0.1/raterunner_0.0.1_linux_amd64.apksudo apk add --allow-untrusted raterunner_0.0.1_linux_amd64.apk

Manual download

bash

# AMD64curl -sL https://github.com/raterunner/cli/releases/download/v0.0.1/raterunner_0.0.1_linux_amd64.tar.gz | tar xzsudo mv raterunner /usr/local/bin/# ARM64curl -sL https://github.com/raterunner/cli/releases/download/v0.0.1/raterunner_0.0.1_linux_arm64.tar.gz | tar xzsudo mv raterunner /usr/local/bin/

Windows

Download the latest Windows archive from GitHub Releases.

Platform	Architecture	File
Windows	x64	`raterunner_VERSION_windows_amd64.zip`
Windows	ARM64	`raterunner_VERSION_windows_arm64.zip`

Extract the archive and add the raterunner executable to your PATH.

All release artifacts

Platform	Architecture	Package
macOS	Apple Silicon	`raterunner_VERSION_darwin_arm64.tar.gz`
macOS	Intel	`raterunner_VERSION_darwin_amd64.tar.gz`
Linux	x64	`raterunner_VERSION_linux_amd64.tar.gz`
Linux	ARM64	`raterunner_VERSION_linux_arm64.tar.gz`
Linux	Debian/Ubuntu x64	`raterunner_VERSION_linux_amd64.deb`
Linux	RHEL/Fedora/CentOS x64	`raterunner_VERSION_linux_amd64.rpm`
Linux	Alpine x64	`raterunner_VERSION_linux_amd64.apk`
Windows	x64	`raterunner_VERSION_windows_amd64.zip`
Windows	ARM64	`raterunner_VERSION_windows_arm64.zip`

Go install

bash

go install github.com/raterunner/cli/cmd/raterunner@latest

Build from source

bash

git clone https://github.com/raterunner/cli.gitcd climake buildsudo mv bin/raterunner /usr/local/bin/

Verify

After installation, verify that the CLI is available:

bash

raterunner --version

Expected output:

text

raterunner version 0.0.1

Requirements

For sync operations, you need a Stripe API key from the Stripe Dashboard.

Set it as an environment variable:

bash

export STRIPE_SANDBOX_KEY=sk_test_...export STRIPE_PRODUCTION_KEY=sk_live_...

Never commit provider credentials. Keep them in your deployment secrets, shell environment, or local .env files that are ignored by Git.

Next steps

Initialize a project with raterunner init.
Configure plans and entitlements.
Preview and apply provider changes.