Installation

Install the a2acli binary with whichever method fits your platform, then verify the install. Once it is on your PATH, head to the Quickstart.

Install

Homebrew (macOS/Linux)

brew tap ghchinoy/tap
brew trust ghchinoy/tap
brew install a2acli

install.sh (Linux)

curl -sL https://raw.githubusercontent.com/ghchinoy/a2acli/main/scripts/install.sh | bash

apt (Debian/Ubuntu)

Download the .deb from the latest release, then:

sudo dpkg -i a2acli_*.deb

rpm (Fedora/RHEL)

Download the .rpm from the latest release, then:

sudo rpm -i a2acli_*.rpm

winget (Windows)

winget install ghchinoy.a2acli

go install

go install github.com/ghchinoy/a2acli/cmd/a2acli@latest

Ensure your Go binary directory is on your PATH (add this to ~/.bashrc or ~/.zshrc):

export PATH="$PATH:$(go env GOPATH)/bin"

From source

git clone https://github.com/ghchinoy/a2acli.git
cd a2acli
make build   # binary is written to bin/a2acli

Optional: the a2a shorthand

To use a2a as a convenient shorthand for a2acli, add an alias to your shell profile:

alias a2a="a2acli"

Verify your install

1. Run the version command:

   a2acli version

2. You should see version, commit, and build-date information.

If the command isn’t found, ensure your install location is on your PATH — for example $(go env GOPATH)/bin for go install, or ./bin when building from source.

Next steps

• Quickstart (5 minutes) — the local serve → discover → send loop.
• Direct-usage tutorial — the full end-to-end walkthrough, including pointing at a real, OAuth-protected agent.