🐙 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

curl -sSL https://raw.githubusercontent.com/darksworm/argonaut/main/install.sh | sh

curl -sSL https://raw.githubusercontent.com/darksworm/argonaut/main/install.sh | sh -s -- v1.13.0

brew tap darksworm/homebrew-tap
brew install darksworm/tap/argonaut

yay -S argonaut-bin

nix run github:darksworm/argonaut

nix develop github:darksworm/argonaut

inputs = {
  argonaut = {
    url = "github:darksworm/argonaut";
    inputs.nixpkgs.follows = "nixpkgs";
  };
  # ...
}

docker pull ghcr.io/darksworm/argonaut:latest

docker run -it --rm \
  -u $(id -u):$(id -g) \
  -v ~/.config/argocd:/home/appuser/.config/argocd:ro \
  ghcr.io/darksworm/argonaut:latest

⚡ 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

Port-forward mode

If your Argo CD server isn't directly accessible (e.g., running in a private cluster), Argonaut can connect via kubectl port-forward:

# Configure ArgoCD CLI for port-forward mode
argocd login --port-forward --port-forward-namespace argocd
Start Argonaut (automatically detects port-forward mode)
argonaut

Requirements:

• kubectl configured with access to the cluster
• ArgoCD server pod running in the target namespace

Custom namespace: If ArgoCD is installed in a different namespace, add to your config:

# ~/.config/argonaut/config.toml
[port_forward]
namespace = "my-argocd-namespace"

⚙️ Configuration

Argonaut stores its configuration in a TOML file at ~/.config/argonaut/config.toml (or $XDG_CONFIG_HOME/argonaut/config.toml).

You can override the config path with the ARGONAUT_CONFIG environment variable.

Example Configuration

[appearance]
theme = "tokyo-night"
[appearance.overrides]
Override individual theme colors (hex format)
accent = "#ff79c6"
success = "#50fa7b"
[sort]
field = "name"      # name, sync, health
direction = "asc"   # asc, desc
[k9s]
command = "k9s"           # Path to k9s executable
context = ""              # Override Kubernetes context for k9s
[diff]
viewer = ""               # Interactive diff viewer (e.g., "code --diff {left} {right}", "meld {left} {right}")
formatter = ""            # Diff formatter command (e.g., "delta --side-by-side")
[http_timeouts]
request_timeout = "10s"   # Timeout for HTTP requests (increase for large deployments)
Start in apps view instead of clusters (supports :command syntax)
default_view = "apps"

Configuration Options

[appearance]

Available themes:

• Dark themes: catppuccin-mocha, dracula, gruvbox-dark, monokai, nord, one-dark, oxocarbon, solarized-dark, tokyo-night, tokyo-storm
• Light themes: catppuccin-latte, gruvbox-light, one-light, onehalf-light, solarized-light
• Accessibility: colorblind-safe, grayscale-lowchroma, high-contrast
• Special: inherit-terminal (uses your terminal's ANSI color palette)

You can also change the theme at runtime using the :theme <name> command.

[appearance.overrides]

Override individual theme colors with hex values. Available color keys:

• accent, warning, dim, success, danger, progress, unknown, info, text, gray
• selected_bg, cursor_selected_bg, cursor_bg, border, muted_bg, shade_bg, dark_bg

[sort]

You can also change sorting at runtime using the :sort <field> <direction> command.

[k9s]

Integration settings for k9s, the Kubernetes TUI.

Press K on a resource in the tree view to open it in k9s.

[diff]

Settings for diff viewing and formatting.

Examples:

[diff]
# Use VS Code as diff viewer
viewer = "code --diff {left} {right} --wait"
Use meld as diff viewer
viewer = "meld {left} {right}"
Use delta with custom options
formatter = "delta --side-by-side --line-numbers"

If no viewer is set, diffs are shown in an internal pager. If no formatter is set but delta is installed, it will be used automatically.

[http_timeouts]

Settings for HTTP request timeouts. Useful for large deployments with thousands of applications where API responses take longer.

Examples:

[http_timeouts]
# For large deployments with thousands of applications
request_timeout = "60s"
For very large deployments
request_timeout = "2m"

Note: If you're experiencing timeout errors when listing applications or resources, increase this value. The timeout applies to all API operations including listing applications, getting resources, and sync operations.

default_view

Configure which view Argonaut starts in. Uses the same syntax as :commands, with an optional scope argument to drill down into a specific cluster, namespace, project, or application set.

All view aliases from :commands are supported (e.g., app/apps/applications, cls/cluster/clusters, ns/namespace/namespaces, etc.).

Examples:

# Start in apps view
default_view = "apps"
Start scoped to a cluster (shows its namespaces)
default_view = "cluster production"
Start scoped to a namespace (shows its projects)
default_view = "ns my-namespace"

[port_forward]

Settings for port-forward mode (when ArgoCD CLI is configured with server: port-forward).

🤝 Contributing

See CONTRIBUTING.md for guidelines on how to contribute to this project.