Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.buttons.sh/llms.txt

Use this file to discover all available pages before exploring further.

Buttons ships as a single static binary for macOS and Linux (amd64 + arm64). No runtime dependencies.

​
curl (macOS / Linux)

The fastest path for a single machine: 
curl -fsSL https://raw.githubusercontent.com/autonoco/buttons/main/install.sh | sh
The script detects your OS and architecture, downloads the matching archive from GitHub Releases, verifies the SHA256 checksum, and installs to /usr/local/bin. Uses sudo only if the target directory isn’t writable.

​
Pin a version

curl -fsSL https://raw.githubusercontent.com/autonoco/buttons/main/install.sh | BUTTONS_VERSION=v0.1.0 sh

​
Custom install directory

curl -fsSL https://raw.githubusercontent.com/autonoco/buttons/main/install.sh | BUTTONS_INSTALL_DIR=$HOME/.local/bin sh

​
Docker (for deployed agents)

Multi-arch image on GitHub Container Registry: 
docker pull ghcr.io/autonoco/buttons:latest
docker run --rm ghcr.io/autonoco/buttons:latest version
Most agent deployments bake the binary into their own image via multi-stage copy: 
FROM python:3.12-slim AS agent
# your agent setup...

COPY --from=ghcr.io/autonoco/buttons:v0.1.0 /usr/local/bin/buttons /usr/local/bin/buttons
The image is Alpine-based with /bin/sh, so shell buttons work out of the box. Add python3 or nodejs via apk add in derived images when those runtimes are needed.
For one-off invocations with state persisted to the host:
docker run --rm -v $PWD/.buttons:/home/buttons/.buttons \
  ghcr.io/autonoco/buttons:latest press weather --arg city=Miami

​
Go

If you already have a Go toolchain: 
go install github.com/autonoco/buttons@latest
Installs to $(go env GOPATH)/bin (usually ~/go/bin). Make sure that directory is on your $PATH.

​
Homebrew

brew install autonoco/tap/buttons
The tap auto-publishes on every release, so brew upgrade buttons always gets you the newest version. Supports macOS and Linux on both Intel and Apple Silicon.

​
Verify

buttons version
buttons version --json
buttons --version

​
Updating

The fastest way to update is the built-in self-update command: 
buttons update
This downloads the latest release, verifies the SHA256 checksum, and atomically replaces the running binary. Use --check to see if an update is available without installing. You can also update through your original install channel:
Installed viaUpdate with
Self-updatebuttons update
curlRe-run the same curl | sh command
Dockerdocker pull ghcr.io/autonoco/buttons:latest
Gogo install github.com/autonoco/buttons@latest
Homebrewbrew upgrade buttons
If you installed via Homebrew, buttons update detects this and asks you to use brew upgrade instead.