argonaut

Keyboard-first terminal UI for Argo CD. Browse apps, scope by clusters/namespaces/projects, stream live resource status, trigger syncs, inspect diffs, and roll

What is argonaut?

Keyboard-first terminal UI for Argo CD. Browse apps, scope by clusters/namespaces/projects, stream live resource status, trigger syncs, inspect diffs, and roll back safely — all without leaving your terminal.

Overview of argonaut

What it is

Argonaut is a keyboard-first terminal UI for Argo CD, built with Bubbletea. It lets you browse applications, scope by clusters, namespaces and projects, stream live resource status, trigger syncs, inspect diffs in your preferred pager, and roll back — all without leaving the terminal. The README describes it as inspired by the UX of k9s, but for Argo CD. It requires the Argo CD CLI; Delta is optional for enhanced diffs and falls back to git.**

Key features

**

  • Instant app browsing with live updates over NDJSON streams
  • Scoped navigation: clusters → namespaces → projects → apps
  • Command palette (:) for actions such as sync, diff, rollback and resources
  • Live resources view per app with health and sync status, plus an events and sync status pane beside the resource tree that auto-refreshes
  • External diff integration that prefers delta and falls back to git --no-index diff | less
  • Guided rollback with revision metadata and progress streaming
  • Execute actions on resources, discovered dynamically per resource, including Argo Rollouts and custom-defined actions**

Use cases

**

  • Reviewing application health and sync state across clusters, namespaces and projects
  • Triggering syncs and inspecting diffs from the terminal
  • Rolling back to a previous revision with revision metadata shown
  • Running resource actions, including Argo Rollouts actions
  • Connecting to an Argo CD server that is not directly reachable, via kubectl port-forward mode
  • Authenticating with client certificates, or trusting a custom CA certificate for self-signed servers**

Getting started

Prerequisites: the Argo CD CLI installed. Delta is optional for enhanced diffs.bash# Log in to your Argo CD serverargocd login# Start ArgonautargonautInstall script (Linux/macOS):bashcurl -sSL https://raw.githubusercontent.com/darksworm/argonaut/main/install.sh | shHomebrew is also documented:bashbrew tap darksworm/homebrew-tapbrew install darksworm/tap/argonaut

License and pricing

**Argonaut is released under the GPL-3.0 license. It is open source; the README and metadata state no pricing.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/darkswormargonaut.svg)](https://yunodb.com/tools/darkswormargonaut?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/darkswormargonaut?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/darkswormargonaut.svg" alt="Featured on YunoDB" height="20"></a>