🐙 Argonaut — Argo CD TUI

💥   v2 - rewritten in golang!

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

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 to git --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

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