Argonaut is a keyboard-first terminal UI for Argo CD, built with React + Ink. 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

npm i --global argonaut-cli

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

yay -S argonaut-bin

# 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

• Prebuilt images are published for releases to ghcr.io/darksworm/argonaut.
• Local builds work cross-platform via a multi-stage Dockerfile.

Pull and run:

docker run --rm -it ghcr.io/darksworm/argonaut:latest

Build locally and run:

# Build (uses buildx automatically if enabled)
bun run docker:build

# Run (pass CLI flags after image name)
bun run docker:run

Multi-arch build with buildx (optional):

docker buildx build \
  --platform linux/amd64,linux/arm64 \
  -t ghcr.io/darksworm/argonaut:dev .