argonaut

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

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.