README
¶
🐙 Argonaut — Argo CD TUI
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.
📦 Prerequisites
- Argo CD CLI installed
- Delta installed for enhanced diffs (optional, falls back to
git)
🚀 Installation methods
Install Script (Linux/macOS)
curl -sSL https://raw.githubusercontent.com/darksworm/argonaut/main/install.sh | sh
The 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.0
Homebrew (Linux/MacOS)
brew tap darksworm/homebrew-tap
brew install darksworm/tap/argonaut
AUR (Arch User Repository)
yay -S argonaut-bin
Nix
With Nix and Flakes enabled, you can run or install Argonaut directly from the repository.Run Directly
To run Argonaut without permanently installing it, use the nix run command:
nix run github:darksworm/argonaut
Development Shell
To 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/argonaut
Flakes
If 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:latest
Run with mounted Argo CD config:
docker run -it --rm \
-v ~/.config/argocd:/root/.config/argocd:ro \
ghcr.io/darksworm/argonaut:latest
The 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.
⚡ Quickstart
# Log in to your Argo CD server
argocd login
# Start Argonaut
argonaut
✨ Highlights
- 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
📸 Screenshots
Live Apps
Sync
Live Resources
Diff
Rollback
Delete apps
Enjoy colorful themes
Advanced Features
Client certificate authentication
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/key
Self-signed certificates
If your Argo CD server uses a self-signed certificate, you can provide a custom CA certificate to trust:
argonaut --ca-cert=/path/to/ca.crt
🤝 Contributing
See CONTRIBUTING.md for guidelines on how to contribute to this project.
Directories