Argonaut is a keyboard-first terminal UI for Argo CD, built with Bubbletea. Browse apps, scope by clusters/namespaces/projects, stream live resource status, trigger syncs, inspect diffs in your favorite pager, and roll back safely — all without leaving your terminal.
❤️ 🐶 Inspired by the great UX of k9s — but for Argo CD.
- Argo CD CLI installed
- Delta installed for enhanced diffs (optional, falls back to
git)
Install Script (Linux/macOS)
curl -sSL https://raw.githubusercontent.com/darksworm/argonaut/main/install.sh | shThe install script automatically detects your system (including musl vs glibc on Linux) and downloads the appropriate binary from the latest release.
You can also install a specific version:
curl -sSL https://raw.githubusercontent.com/darksworm/argonaut/main/install.sh | sh -s -- v1.13.0Homebrew (Linux/MacOS)
brew tap darksworm/homebrew-tap
brew install darksworm/tap/argonautAUR (Arch User Repository)
yay -S argonaut-binNix
With Nix and Flakes enabled, you can run or install Argonaut directly from the repository.To run Argonaut without permanently installing it, use the nix run command:
nix run github:darksworm/argonautTo enter a development shell with Argonaut and its dependencies (like Go, Delta, and Argocd) available for development, use the nix develop command:
nix develop github:darksworm/argonautIf you are using Flakes to manage your systems add this to your Flake:
inputs = {
argonaut = {
url = "github:darksworm/argonaut";
inputs.nixpkgs.follows = "nixpkgs";
};
# ...
}Docker
Pull the image:
docker pull ghcr.io/darksworm/argonaut:latestRun with mounted Argo CD config:
docker run -it --rm \
-v ~/.config/argocd:/root/.config/argocd:ro \
ghcr.io/darksworm/argonaut:latestThe container needs access to your Argo CD configuration for authentication. The :ro flag mounts it as read-only for security.
Download a binary
You can download binaries and packages in from the latest release.
# Log in to your Argo CD server
argocd login
# Start Argonaut
argonaut- Instant app browsing with live updates (NDJSON streams)
- Scoped navigation: clusters → namespaces → projects → apps
- Command palette (
:) for actions:sync,diff,rollback,resources, etc. - Live resources view per app with health & sync status
- External diff integration: prefers
delta, falls back togit --no-index diff | less - Guided rollback with revision metadata and progress streaming
- Keyboard-only workflow with Vim-like navigation
Argonaut supports client certificate authentication. You just need to pass a couple arguments to the argonaut command:
argonaut --client-cert=/path/to/cert --client-cert-key=/path/to/keyIf your Argo CD server uses a self-signed certificate, you can provide a custom CA certificate to trust:
argonaut --ca-cert=/path/to/ca.crtSee CONTRIBUTING.md for guidelines on how to contribute to this project.