D

ArgoCD

ArgoCD CLI commands for managing GitOps application sync, diff and rollback.

Updated 2026-09-03

Cheat SheetTroubleshooting
On this page

ArgoCD continuously reconciles a Kubernetes cluster's live state against manifests declared in Git — "sync" means making the cluster match Git, not the other way around.

Login

argocd login argocd.example.com

Authenticates the CLI against an ArgoCD server, prompting for credentials.

argocd login argocd.example.com --sso

Authenticates via the configured SSO provider instead of a local username/password.

Applications

argocd app list

Lists every application ArgoCD manages, with its sync and health status.

argocd app get my-app

Shows an application's full detail — source repo, destination, sync status, and resource tree.

argocd app create my-app --repo https://github.com/org/repo.git --path k8s --dest-server https://kubernetes.default.svc --dest-namespace default

Registers a new application, pointing ArgoCD at a Git path to track.

Sync

argocd app sync my-app

Applies the difference between Git and the live cluster, bringing the cluster in line with what's declared in Git.

argocd app sync my-app --prune

Syncs and also deletes any live resource that's no longer declared in Git.

argocd app sync my-app --dry-run

Shows what a sync would do without actually applying anything.

argocd app diff my-app

Shows exactly what differs between the live cluster state and the manifests in Git, before you sync.

History & Rollback

argocd app history my-app

Lists previous sync revisions for an application.

argocd app rollback my-app 5

Rolls an application back to a specific historical revision number.

Inspecting Resources

argocd app resources my-app

Lists the individual Kubernetes resources an application manages.

argocd app logs my-app

Streams logs from the pods belonging to an application, without needing kubectl context switching.

argocd app manifests my-app

Prints the fully rendered manifests ArgoCD generated from the source (after Helm/Kustomize templating, if applicable).

Projects

argocd proj list

Lists ArgoCD projects — the mechanism for restricting which repos, clusters and namespaces a group of applications can use.

Sync policies

An application can be set to automated sync (ArgoCD applies Git changes on its own, optionally with prune and selfHeal) or manual (a human runs argocd app sync). Automated with selfHeal also reverts manual kubectl edit drift back to what Git declares — genuinely enforcing Git as the source of truth, not just a starting point.

Official documentation

Related

KubernetesFluxCDHelm