home / containers / argocd

Argo CD CLI

Official · Argo Project
22k

GitOps CLI for inspecting, diffing, syncing, and managing Argo CD applications, projects, clusters, and repos.

$brew install argocd
Language
Go
Stars
22,254
Category
Containers & K8s
Agent
Ready
Agent Compatibility
JSON Output
Agent Skill
MCP Support
AI Analysis

argocd is the command line client for Argo CD, a GitOps continuous delivery system for Kubernetes. It lets you inspect application state, compare desired versus live resources, trigger syncs, and administer the clusters, repos, and projects Argo CD manages.

What It Enables
  • Inspect applications, manifests, resource trees, logs, history, sync status, and health, then wait for specific sync or health conditions from scripts.
  • Diff live versus target state, trigger syncs or rollbacks, patch or delete app resources, and scope operations to selected resources, labels, revisions, or local manifests.
  • Manage the surrounding control plane by listing or updating clusters, repositories, projects, accounts, certificates, and other Argo CD configuration from the terminal.
Agent Fit
  • Many read paths support -o json, so application, repository, cluster, project, account, and version data can be parsed directly in shell or CI workflows.
  • Automation fit is strong because commands are mostly non-interactive once auth is in place, and operations like app diff, app sync, and app wait expose flags and exit behavior that suit inspect-change-verify loops.
  • It is most useful for agents that already operate inside a Kubernetes or GitOps environment; --core broadens that fit by allowing direct Kubernetes-backed operation when a full Argo CD API server is not the control point.
Caveats
  • Useful operation depends on a reachable Argo CD deployment or enough Kubernetes RBAC for --core, plus preconfigured auth, context, and cluster access.
  • Some flows still assume a human, especially login --sso, browser-based auth, and sync previews or prompts unless you choose non-interactive flags.