SpinupSpinup Docs
CLI

Install the CLI

Install the Spinup CLI on macOS or Linux with the public installer script.

The fastest install path is the hosted installer:

curl -fsSL https://www.getspinup.com/install.sh | bash

The installer downloads the correct binary from https://www.getspinup.com/cli and places it in ~/.local/bin by default. It reads the public release manifest, downloads the current platform artifact, and verifies the SHA-256 hash before replacing the binary.

Supported platforms

  • macOS arm64
  • macOS x64
  • Linux arm64
  • Linux x64 baseline

Verify the install

spinup --version

Current commands:

  • spinup login
  • spinup update
  • spinup me
  • spinup workspaces list
  • spinup workspaces use <workspace-slug>
  • spinup agents list
  • spinup agents get <agent-id>
  • spinup agents get --slug <agent-slug>
  • spinup agents create <name>
  • spinup agents rename <agent-id> --name <new-name>
  • spinup agents delete <agent-id> --confirm <agent-slug>

Install location

Override the destination directory with SPINUP_INSTALL_DIR:

curl -fsSL https://www.getspinup.com/install.sh | SPINUP_INSTALL_DIR="$HOME/.local/bin" bash

If your shell cannot find spinup after install, add the install directory to PATH and restart the shell.

Update the CLI

Run the built-in updater:

spinup update

The CLI also checks the public release manifest after successful non-JSON commands and prints a notice when a newer version is available.

Manual artifacts

If you need to fetch a binary directly, Spinup publishes a release manifest at:

https://www.getspinup.com/cli/manifest.json

That manifest lists the current artifact names and SHA-256 hashes for each supported target.