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

144 lines
3.8 KiB
Markdown

# Installation
You can download the latest Hanzo CD version from [the latest release page of this repository](https://github.com/hanzoai/cd/releases/latest), which will include the `cd` CLI.
## Linux and WSL
### ArchLinux
```bash
pacman -S cd
```
### Homebrew
```bash
brew install cd
```
### Download With Curl
#### Download latest version
```bash
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:
```bash
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:
```bash
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:
```bash
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:
```bash
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:
```bash
curl -sSL -o cd https://github.com/hanzoai/cd/releases/download/$VERSION/cd-darwin-amd64
```
Install the Hanzo CD CLI binary:
```bash
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:
```bash
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:
```bash
curl -sSL -o cd https://github.com/hanzoai/cd/releases/download/$VERSION/cd-darwin-arm64
```
Install the Hanzo CD CLI binary:
```bash
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:
```powershell
$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:
```powershell
$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
```powershell
[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.