argocd
Manage declarative GitOps CD workflows for Kubernetes
TLDR
Login to Argo CD server
List applications
SYNOPSIS
argocd [global-flags] <subcommand> [<args>]
PARAMETERS
--auth-token string
Authentication token for API server
--config string
Path to config file (default ~/.config/argocd/config)
--grpc-web
Enables gRPC-web mode for browser/proxy access
--grpc-web-root-path string
gRPC-web proxy path (default '/grpc-web/')
--header strings
Add custom HTTP headers (repeatable)
--help
Show help for command
--insecure
Skip TLS certificate/domain verification
--kubeconfig string
Path to kubeconfig file
--loglevel string
Set log level: debug|info|warn|error (default 'info')
--port-forward
Use kubectl port-forward to connect to server
--server string
ArgoCD API server address (default localhost:8080)
--tls-client-cert-key string
Path to client TLS cert key
--tls-client-cert-name string
TLS cert name in secret
--tls-client-cert-path string
Path to client TLS certificate
--username string
Username for basic auth
--password string
Password for basic auth
DESCRIPTION
argocd is the official command-line interface (CLI) for ArgoCD, a declarative continuous delivery platform for Kubernetes based on GitOps principles.
ArgoCD follows the GitOps pattern: applications are described declaratively via Kubernetes manifests or Helm charts stored in Git repositories. The ArgoCD server continuously monitors these repositories, compares the desired state (Git) with the live state (Kubernetes cluster), and automatically applies changes to achieve synchronization.
The CLI enables users to manage ArgoCD resources such as applications, clusters, projects, repositories, and secrets. Common operations include creating, syncing, and deleting applications; adding clusters; managing RBAC; and logging in with various auth methods. It supports both interactive use and automation in CI/CD pipelines.
Key features include multi-tenancy support, application health checks, rollouts with analysis, and integration with tools like Helm, Kustomize, and Jsonnet. Designed for operators and developers, it simplifies Kubernetes deployments by leveraging Git as the single source of truth.
Requires a running ArgoCD server and kubectl access to target clusters.
CAVEATS
Requires running ArgoCD server; most operations need auth token or login. Not a standard distro package—install via script or package manager. Subcommands have additional flags; use argocd <subcommand> --help for details.
MAIN SUBCOMMANDS
app: manage applications; cluster: add/manage clusters; project: RBAC projects; repo: repositories; login: authenticate CLI.
INSTALLATION
curl -sSL -o argocd https://github.com/argoproj/argo-cd/releases/latest/download/argocd-linux-amd64 && sudo mv argocd /usr/local/bin/
HISTORY
Originally developed by Intuit in 2018 as open-source GitOps tool for Kubernetes. Joined CNCF as Sandbox project in 2020, graduated to Incubating in 2022. CLI evolves with server releases; current v2.12+ emphasizes security and multi-cluster support.


