Installation
Homebrew (macOS and Linux)
brew install k2m30/a9s/a9s
Scoop (Windows)
scoop bucket add a9s https://github.com/k2m30/scoop-a9s.git
scoop install a9s
Go install
go install github.com/k2m30/a9s/v3/cmd/a9s@latest
Download binary
Download the latest release for your platform from GitHub Releases.
Available platforms:
- macOS: Intel (amd64) and Apple Silicon (arm64)
- Linux: amd64 and arm64
- Windows: amd64 and arm64
Windows note: Downloaded binaries may trigger a Microsoft Defender SmartScreen warning because they are not code-signed. Click “More info” → “Run anyway” to proceed, or install via Scoop to avoid this. Windows support is new and has been verified via cross-compilation and CI only — the maintainer does not have a Windows machine. If you encounter any issues, please open an issue.
Docker
# Demo mode (no AWS credentials needed)
docker run --rm -it ghcr.io/k2m30/a9s:latest --demo
# Real AWS access
docker run --rm -it -v ~/.aws/config:/home/a9s/.aws/config:ro ghcr.io/k2m30/a9s:latest
Build from source
Requires Go 1.26+.
git clone https://github.com/k2m30/a9s.git
cd a9s
make build
./a9s
Quick Start
a9s uses the standard AWS credential chain. Any of these work:
- Environment variables (
AWS_ACCESS_KEY_ID,AWS_SECRET_ACCESS_KEY) - AWS config file (
~/.aws/config) — a9s never reads~/.aws/credentials - EC2 instance metadata / ECS task role / SSO
a9s # use default profile
a9s -p production # use a specific profile
a9s -r eu-west-1 # override region
a9s --version # print version