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)

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

# 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 to git --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/key

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

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"

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.

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

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.

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

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

Integration settings for k9s, the Kubernetes TUI.

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

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.

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.

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"

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

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