argoxd helps Kubernetes and platform engineers operate Argo CD from the terminal: browse applications and resources, inspect YAML, diffs, logs, and events, then sync, refresh, restart, delete, or roll back with confirmation.
It is open-source software for GitOps operations, available for macOS, Linux, and Windows. Connect with kubeconfig or directly to the Argo CD API.
Day-to-day Argo CD, at k9s speed.
List Applications, AppProjects and Clusters. Press Enter to drill into an Application's resources, Esc to go back. Command bar with :, search with /.
Connect with your kubeconfig, or to the Argo CD API with --source api and a token — or reuse the login already saved by argocd login, with a custom CA and client certificates when the server needs them. Hop between clusters with :ctx and between Argo CD instances with :ns, without restarting.
Deployments → ReplicaSets → Pods nested under their owners. Switch to a table with w, fold cards with ←/→ or z, and keep the selected card's events in a pane with E. Open live YAML (Y), yank names or text (y), diff against desired state (d), Pod logs (l) and events (e).
Mark rows with Space, then sync, refresh, restart or delete them together. Every action shows exactly what it will touch and waits for confirmation first. Run with --read-only to block them all.
l on a Deployment, StatefulSet or Job streams all its Pods at once, each line tagged with its Pod. Follow with f, switch container with c or Pod with p, filter with /.
Enter on a child Application opens it, Esc returns to the parent, breadcrumbs show the path. :appset lists ApplicationSets with their generators and problems, and Enter shows what each generated.
:pulse draws health and sync as bars, counts auto-sync policies, and lists the Applications that need attention — worst first, with the reasons.
See which resources a sync with prune would delete and which ones no Application manages. Check conditions, sync details (i) and history, then roll back with h.
Pick a theme with :theme — light, high-contrast, colorblind, nord, dracula or your terminal's own colors — or define your own in the config file. Sort Applications with :sort, start in the view you use most, and turn on the mouse wheel with --mouse.
:k9s opens k9s on the selected resource's namespace and kind, with the same kubeconfig and context. In a diff, x hands it to meld, code --diff or whatever diffViewer names.
Linux, macOS and Windows.
A taste of the keymap — the full list is in the README.
| Key | Action |
|---|---|
| Enter | Open an Application's dependencies, an ApplicationSet's Applications, or a child app |
| Space | Mark Applications or resource cards; bulk actions apply to everything marked |
| y v | Yank item name or open viewer text · visual line selection |
| Y d l e | YAML manifest · diff · logs · events of the selected card or app |
| w | Switch an Application's resources between cards and a table |
| ← → z | Fold the selected card · unfold it · fold or unfold every card |
| E [ ] | Events pane under the cards · scroll it through older and newer events |
| s R D T | Sync · refresh · delete · terminate operation (always asks first) |
| o | Open selected Application in the Argo CD web UI (--source api) |
| x X | Rolling-restart a workload (in a diff, opens your viewer) · delete a Pod |
| h i P | Deployment history & rollback · sync details · sync policy |
| H S K | Filter by health · sync status · resource kind, with suggestions |
| : / | Command bar (e.g. :ctx, :ns, :sort, :theme, :k9s) · search as you type |
| Esc | Back, or clear search and filters |
argoxd can sync and delete, so it is built to make that hard to do by accident.
Sync, refresh, rollback, terminate, restart and delete show the exact Applications or resources they will touch, and wait for Enter.
--read-only or readOnly: true blocks every action that changes something, and the header shows [READ-ONLY].
argoxd acts as your kubeconfig user or Argo CD token. It cannot do anything your RBAC does not already allow.
Nothing runs in the cluster. It is a single binary that talks to the Kubernetes or Argo CD API you already use.
Need a read-only identity for your team? The README has a ready-made Role and the full permission list.
argoxd is an open-source terminal user interface for Argo CD. It brings a resource-focused, k9s-style workflow to GitOps operations, so you can inspect and act on Argo CD Applications and their Kubernetes resources without leaving the terminal.
By default, it uses your active kubeconfig context and looks for Argo CD in the argocd namespace. You can instead use the Argo CD API with --source api: pass a server URL and token, or reuse the login already saved by argocd login. A custom CA and client certificates are supported when the server needs them.
Yes. Run argoxd --demo to explore sample applications, resources, YAML, diffs, and logs. It needs no cluster or credentials, and its actions change only in-memory sample data.
argoxd supports macOS, Linux, and Windows. Install with Homebrew on macOS or Linux, with go install, or by downloading a prebuilt binary from GitHub Releases.
Yes, with care. Every action shows what it will touch and waits for confirmation, --read-only blocks all of them, and argoxd can only do what your own kubeconfig user or Argo CD token is allowed to do. Nothing is installed in the cluster.
To browse, it needs to list Argo CD's Applications, AppProjects and cluster Secrets. Logs, events and workloads need the matching read access, and each action needs its own write permission. The README lists them all and includes a ready-made read-only Role.
Yes. :ctx switches the kubeconfig context and :ns switches the namespace Argo CD runs in, both without restarting. Marks are cleared on every switch, so an action never carries over to another instance.
Yes. :theme switches between built-in themes such as light, high-contrast, colorblind, nord and dracula, and you can define your own in the config file. :sort orders Applications, the mouse wheel is opt-in with --mouse, and the events pane can open by default.
Yes. With --source api and a server URL and token — or the login saved by argocd login — argoxd talks only to the Argo CD API. That mode also adds diffs, orphaned resources and opening apps in the web UI.