peterj/argocd-cli-setup
skills/argocd-cli-setup/SKILL.md
Guides installation of the Argo CD CLI across Linux, WSL, macOS (Apple Silicon), and Windows. Also covers Argo CD core concepts such as Application, Sync, Target State, Live State, Refresh, and Health. Use when setting up the argocd CLI, troubleshooting argocd installation, or when the user needs to understand Argo CD terminology and GitOps concepts.
tools
Updated Apr 25, 2026
$ install --global
skillsauthnpx skillsauth add peterj/skills argocd-cli-setupInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 25, 2026, 8:03 PM137.5s3 files scanned
SKILL.md
- name:
- argocd-cli-setup
- description:
- Guides installation of the Argo CD CLI across Linux, WSL, macOS (Apple Silicon), and Windows. Also covers Argo CD core concepts such as Application, Sync, Target State, Live State, Refresh, and Health. Use when setting up the argocd CLI, troubleshooting argocd installation, or when the user needs to understand Argo CD terminology and GitOps concepts.
Argo CD CLI Installation & Core Concepts
Quick start — Install the CLI
Homebrew (Linux, WSL, macOS)
brew install argocd
Linux / WSL — curl (latest stable)
VERSION=$(curl -L -s https://raw.githubusercontent.com/argoproj/argo-cd/stable/VERSION)
curl -sSL -o argocd-linux-amd64 https://github.com/argoproj/argo-cd/releases/download/v$VERSION/argocd-linux-amd64
sudo install -m 555 argocd-linux-amd64 /usr/local/bin/argocd
rm argocd-linux-amd64
macOS Apple Silicon — curl
VERSION=$(curl --silent "https://api.github.com/repos/argoproj/argo-cd/releases/latest" | grep '"tag_name"' | sed -E 's/.*"([^"]+)".*/\1/')
curl -sSL -o argocd https://github.com/argoproj/argo-cd/releases/download/$VERSION/argocd-darwin-arm64
sudo install -m 555 argocd /usr/local/bin/argocd
rm argocd
Windows — PowerShell
$version = (Invoke-RestMethod https://api.github.com/repos/argoproj/argo-cd/releases/latest).tag_name
$url = "https://github.com/argoproj/argo-cd/releases/download/" + $version + "/argocd-windows-amd64.exe"
Invoke-WebRequest -Uri $url -OutFile argocd.exe
[Environment]::SetEnvironmentVariable("Path", "$env:Path;C:\Path\To\ArgoCD-CLI", "User")
Replace C:\Path\To\ArgoCD-CLI with the actual directory containing argocd.exe.
ArchLinux
pacman -S argocd
Download a specific version (Linux)
Set VERSION to the desired Git tag:
VERSION=<TAG>
curl -sSL -o argocd-linux-amd64 https://github.com/argoproj/argo-cd/releases/download/$VERSION/argocd-linux-amd64
sudo install -m 555 argocd-linux-amd64 /usr/local/bin/argocd
rm argocd-linux-amd64
Browse tags at https://github.com/argoproj/argo-cd/releases.
Core concepts
| Term | Meaning | |---|---| | Application | A group of Kubernetes resources defined by a manifest (a CRD). | | Application source type | The Tool used to build the application. | | Target state | The desired state of an application, represented by files in a Git repository. | | Live state | The actual deployed state of the application (pods, services, etc.). | | Sync status | Whether the live state matches the target state. | | Sync | The process of making an application move to its target state (e.g., applying changes to a cluster). | | Sync operation status | Whether a sync succeeded. | | Refresh | Comparing the latest code in Git with the live state to find differences. | | Health | Whether the application is running correctly and can serve requests. | | Tool | A tool to create manifests from a directory of files (e.g., Kustomize). Also called Configuration management tool. | | Configuration management plugin | A custom tool for manifest generation. |
Additional resources
- For detailed per-platform installation steps and notes, see installation.md
Related Skills
peterj/spire
development
VerifiedTrustedCommunity
Guide for installing, configuring, and deploying SPIRE servers and agents. Use when working with SPIRE, SPIFFE, workload identity, trust domains, node attestation, workload attestation, service identity, or X.509/JWT SVIDs on Kubernetes or Linux.
SKILL.mdUpdated Apr 25, 2026
peterj/istio-troubleshooting
development
VerifiedTrustedCommunity
Diagnoses and resolves common Istio service mesh problems across traffic management, security, observability, and upgrades. Use when debugging Istio networking issues (503 errors, route rules not working, TLS mismatches, gateway 404s), security problems (authorization policies, mTLS, JWT authentication), observability gaps (missing traces, Grafana output issues), EnvoyFilter breakage, or when upgrading Istio and migrating from EnvoyFilter to first-class APIs.
SKILL.mdUpdated Apr 25, 2026
peterj/istio-traffic-management
tools
VerifiedTrustedCommunity
Configures Istio traffic management including multicluster traffic control, gateway network topology (XFF/XFCC headers, PROXY protocol), protocol selection, and TLS configuration. Use when working with Istio service mesh traffic routing, multicluster setups, gateway configuration, protocol detection, mTLS settings, or when troubleshooting TLS/proxy header issues.
SKILL.mdUpdated Apr 25, 2026
peterj/istio-ambient-mode
development
VerifiedTrustedCommunity
Guide for installing, deploying, debugging, and cleaning up Istio's ambient mode mesh. Use when working with Istio ambient mode, ztunnel proxies, ambient mesh traffic redirection, istio-cni, HBONE encryption, Bookinfo sample application deployment, or istioctl commands for ambient profile setup and teardown.
SKILL.mdUpdated Apr 25, 2026