Install

spogo ships as a single Go binary. Pick whichever path matches how you usually install CLIs.

#Homebrew (macOS, Linux)

brew install steipete/tap/spogo

The formula pulls a release binary; macOS artifacts are signed and notarized.

#go install (any platform)

go install github.com/steipete/spogo/cmd/spogo@latest

Builds from source with a minimum of Go 1.26.7.

#Pre-built release binaries

Grab a tarball or zip for your OS/arch from the releases page and drop the spogo binary somewhere on PATH:

Asset names include the version, lowercase OS, and Go architecture, for example spogo_0.12.0_darwin_arm64.tar.gz or spogo_0.12.0_windows_amd64.zip. Select the exact asset on the release page, extract it, and run spogo --version. uname output is not an asset filename.

#Build from source

With automatic toolchain selection enabled, checkout builds use the preferred Go 1.27.1 toolchain unless a newer local toolchain is installed.

git clone https://github.com/openclaw/spogo.git
cd spogo
make spogo
./spogo --version

#Verify

spogo --version
spogo --help

If --help lists auth, search, play, library, playlist, device, and friends, you're done. Next stop: Quickstart.

#Uninstall

Homebrew: brew uninstall spogo
go install: rm $(which spogo)
Manual: delete the binary; remove ~/Library/Application Support/spogo (macOS), ~/.config/spogo (Linux), or %APPDATA%\spogo (Windows) to clear cached cookies and config.