Skip to main content

The Akuity CLI

The Akuity CLI allows you to manage the Akuity Platform resources using the operating system's command line. See the CLI reference section for all available commands.



brew install akuity


  1. Download the latest release with the script:
arch=$(uname -m)
[ "$arch" = "x86_64" ] && arch=amd64
curl -L -o akuity "$(curl -sL${arch}/akuity"

The following architectures are available to download: amd64, arm64


To download a specific version, replace the $(curl -sL portion of the command with the specific version.

For example, to download version v0.9.3 on Mac, use:

arch=$(uname -m)
[ "$arch" = "x86_64" ] && arch=amd64
curl -L -o akuity "${arch}/akuity"

Alternatively, you can download the CLI binary from the Akuity Portal UI using the CLI button in the left navigation bar.

  1. Make the akuity binary executable:
chmod +x ./akuity
  1. Move the akuity binary to a file location on your system PATH.
sudo mv ./akuity /usr/local/bin/akuity
sudo chown root: /usr/local/bin/akuity

Make sure /usr/local/bin is in your PATH environment variable.

  1. Check whether the version you've installed is the one you wanted:
akuity version

If your system shows

"akuity" can't be opened because Apple cannot check it for malicious software.

you can allow running it by the following command:

sudo xattr -d /usr/local/bin/akuity

Login to Akuity Platform:

akuity login

Alternatively, you can generate an API token from the Akuity Portal UI using the API Keys tab on the organization profile page and expose the key using AKUITY_API_KEY_ID, AKUITY_API_KEY_SECRET, and optionally AKUITY_SERVER_URL environment variables:

akuity argocd instance list --organization-name <organization-name>