Install the CLI

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 command groups:

• Account and install: spinup login, spinup logout, spinup update, spinup me
• Workspaces: spinup workspaces list, spinup workspaces use <workspace-slug>
• Workspace secrets: spinup secrets list, spinup secrets get <secret-id>, spinup secrets create <name> --projection-name <name> (--value-file <path>|--value-stdin), spinup secrets update <secret-id>, spinup secrets delete <secret-id>
• Agents: spinup agents list, spinup agents get <agent>, spinup agents create <name>, spinup agents update <agent>, spinup agents rename <agent> --name <new-name>, spinup agents delete <agent> --confirm <agent-slug>
• Runtime status and runs: spinup agents status <agent-id>, spinup agents runs create <agent-id> --input <text>, spinup agents runs list <agent-id>, spinup agents runs get <agent-id> <run-id>, spinup agents runs wait <agent-id> <run-id>
• Agent configuration: spinup agents harnesses default <agent> <harness>, spinup agents instructions get|set|clear <agent>, spinup agents setup get|set|clear <agent>, spinup agents runtime-policy set <agent> --install-mode <none|curated|declared>
• Runtime keys and schedules: spinup agents runtime-key issue <agent>, spinup agents schedules list|create|update|disable|delete|preview <agent>
• Capabilities, secrets, and proposed changes: spinup agents capabilities list|add|update|remove <agent>, spinup agents secrets list|set <agent>, spinup agents changes list|get|approve|reject <agent>

Most commands that return structured data accept --json; pass --quiet to suppress non-essential status output. For control-plane commands, <agent> accepts an agent_... ID or a slug, and --slug forces slug lookup for edge cases. Runtime status and run commands use agent IDs with an agent runtime key.

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.