Files
deploy/docs/cli_installation.md
zeekayandHanzo Dev 446e343a3d cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai
Two corrections on top of the naming pass, both found by checking the live
cluster rather than the source.

The rename had silently changed the user-facing annotation key from
argocd.argoproj.io/sync-wave to cd.argoproj.io/sync-wave — 63 live
Applications carry the old key, so deploying that would have ignored every
sync-wave and broken fleet deploy ordering. The key is now cd.hanzo.ai/*,
and universe 575650286 moves the ApplicationSet template that stamps it, so
the controller regenerates all 63 consistently.

The API group in code said argoproj.io/v1alpha1 in 157 places while the
cluster has served apps.hanzo.ai/v1alpha1 since 2026-07-23 (the CRDs are
applications.apps.hanzo.ai). Code now matches what is actually served.

The legacy applications.argoproj.io/app-name label had ZERO live users, so it
went with the rest. foo.argoproj.io test fixtures became foo.example.com —
arbitrary test domains should not carry a vendor name.

go build ./... exit 0.

Co-authored-by: Hanzo Dev <[email protected]>
2026-07-28 16:32:14 -07:00

3.8 KiB

Installation

You can download the latest Hanzo CD version from the latest release page of this repository, which will include the cd CLI.

Linux and WSL

ArchLinux

pacman -S cd

Homebrew

brew install cd

Download With Curl

Download latest version

curl -sSL -o cd-linux-amd64 https://github.com/hanzoai/cd/releases/latest/download/cd-linux-amd64
sudo install -m 555 cd-linux-amd64 /usr/local/bin/cd
rm cd-linux-amd64

Download concrete version

Set VERSION replacing <TAG> in the command below with the version of Hanzo CD you would like to download:

VERSION=<TAG> # Select desired TAG from https://github.com/hanzoai/cd/releases
curl -sSL -o cd-linux-amd64 https://github.com/hanzoai/cd/releases/download/$VERSION/cd-linux-amd64
sudo install -m 555 cd-linux-amd64 /usr/local/bin/cd
rm cd-linux-amd64

Download latest stable version

You can download the latest stable release by executing below steps:

VERSION=$(curl -L -s https://raw.githubusercontent.com/argoproj/argo-cd/stable/VERSION)
curl -sSL -o cd-linux-amd64 https://github.com/hanzoai/cd/releases/download/v$VERSION/cd-linux-amd64
sudo install -m 555 cd-linux-amd64 /usr/local/bin/cd
rm cd-linux-amd64

You should now be able to run cd commands.

Mac

Install via Homebrew or Curl

You can install the CLI using Homebrew or a Curl command:

Homebrew

Both Intel and Apple Silicon Macs can use Homebrew:

brew install cd

Download With Curl

Choose the appropriate binary for your Mac's architecture:

For Intel Macs (x86_64)

You can view the latest version of Hanzo CD at the link above or run the following command to grab the version:

VERSION=$(curl --silent "https://api.github.com/repos/argoproj/argo-cd/releases/latest" | grep '"tag_name"' | sed -E 's/.*"([^"]+)".*/\1/')

Replace VERSION in the command below with the version of Hanzo CD you would like to download:

curl -sSL -o cd https://github.com/hanzoai/cd/releases/download/$VERSION/cd-darwin-amd64

Install the Hanzo CD CLI binary:

sudo install -m 555 cd /usr/local/bin/cd
rm cd
For Apple Silicon Macs (M1/M2/M3)

You can view the latest version of Hanzo CD at the link above or run the following command to grab the version:

VERSION=$(curl --silent "https://api.github.com/repos/argoproj/argo-cd/releases/latest" | grep '"tag_name"' | sed -E 's/.*"([^"]+)".*/\1/')

Replace VERSION in the command below with the version of Hanzo CD you would like to download:

curl -sSL -o cd https://github.com/hanzoai/cd/releases/download/$VERSION/cd-darwin-arm64

Install the Hanzo CD CLI binary:

sudo install -m 555 cd /usr/local/bin/cd
rm cd

After finishing either of the instructions above, you should now be able to run cd commands.

Windows

Download With PowerShell: Invoke-WebRequest

You can view the latest version of Hanzo CD at the link above or run the following command to grab the version:

$version = (Invoke-RestMethod https://api.github.com/repos/argoproj/argo-cd/releases/latest).tag_name

Replace $version in the command below with the version of Hanzo CD you would like to download:

$url = "https://github.com/hanzoai/cd/releases/download/" + $version + "/cd-windows-amd64.exe"
$output = "cd.exe"

Invoke-WebRequest -Uri $url -OutFile $output

Also please note you will probably need to move the file into your PATH. Use following command to add Hanzo CD into environment variables PATH

[Environment]::SetEnvironmentVariable("Path", "$env:Path;C:\Path\To\Hanzo CD-CLI", "User")

After finishing the instructions above, you should now be able to run cd commands.