A K9s-inspired terminal UI for monitoring Flux GitOps resources in real-time.

flux9s provides a terminal-based interface for monitoring and managing Flux CD resources, inspired by the excellent K9s project. It offers real-time monitoring of Flux Custom Resources (CRDs) including Kustomizations, GitRepositories, HelmReleases, and more.

flux9s is listed as a community UI in the Flux ecosystem.

• Real-time monitoring - Watch Flux resources as they change using Kubernetes Watch API
• K9s-inspired interface - Familiar navigation and keybindings for K9s users
• Unified and type-specific views - View all resources together or filter by type
• Resource operations - Suspend, resume, reconcile, and delete Flux resources
• YAML viewing - Inspect full resource manifests
• Kubernetes Events - Per-resource events in the describe view, plus a live :events feed for the current namespace or cluster
• Controller logs - Stream any Flux controller pod's logs live with :logs (follow, search, bounded buffer)
• Workload drill-down - Open a graph workload group to walk Deployments/StatefulSets/DaemonSets: rollout status, containers, pods, events, and pod logs
• Pulse dashboard - :pulse shows cluster health at a glance: per-kind counts, recent failures, and Flux distribution info
• CRD discovery (opt-in) - discoverFluxResources: true dynamically shows any CRD labeled app.kubernetes.io/part-of=flux (Flagger, tofu-controller, ExternalArtifact-SDK controllers), view-only with generic columns
• Graph visualization - Visualize resource relationships and dependencies (Kustomization, HelmRelease, etc.)
• Reconciliation history - View reconciliation history for resources that track it
• Favorites - Mark frequently accessed resources for quick access
• Namespace switching - Monitor resources across namespaces or cluster-wide
• RBAC-aware - When access is denied (HTTP 403), the list shows a clear "restricted" note instead of a silently empty view; missing CRDs stay quiet (toggle with ui.rbacWarnings)
• Status indicators - Visual indicators for resource health and suspension state

The easiest way to install on macOS and Linux:

brew install dgunzy/tap/flux9s

Or tap the repository first:

brew tap dgunzy/tap
brew install flux9s

If you have cargo-binstall installed:

cargo binstall flux9s

This downloads and installs pre-built binaries without compiling from source.

Download pre-built binaries from the Releases page:

• Linux (x86_64): flux9s-linux-x86_64.tar.gz
• macOS (Intel): flux9s-macos-x86_64.tar.gz
• macOS (Apple Silicon): flux9s-macos-aarch64.tar.gz
• Windows (x86_64): flux9s-windows-x86_64.zip

Extract and move the binary to a directory in your PATH.

cargo install flux9s

git clone https://github.com/dgunzy/flux9s.git
cd flux9s
cargo build --release

The binary will be available at target/release/flux9s.

1. Ensure you have a Kubernetes cluster with Flux installed
2. Configure your kubeconfig to point to your cluster
3. Run flux9s

flux9s

By default, flux9s watches the flux-system namespace. Use :ns all to view all namespaces or :ns <namespace> to switch to a specific namespace.

Note: flux9s launches in readonly mode by default.
You can change this with flux9s config set readOnly false or toggle it in a session using :readonly.

• j / k - Navigate up/down
• : - Command mode (e.g., :kustomization, :gitrepository)
• Enter - View resource details
• / - Filter resources by name (list views) or search text (YAML/describe/trace views)
• n / N - Next/previous search match (in text views)
• Shift+N / Shift+A / Shift+T / Shift+S - Sort by name/age/type/status (press again to reverse)
• s - Suspend resource
• r - Resume resource
• R - Reconcile resource
• y - View resource YAML
• e - Edit resource in system editor (opens YAML, applies changes via Server Side Apply on save)
• f - Toggle favorite
• g - View resource graph (Kustomization, HelmRelease, etc.)
• h - View reconciliation history
• t - Trace ownership chain
• W - Reconcile with source (Kustomization, HelmRelease)
• d - Describe resource
• Ctrl+d - Delete resource (with confirmation)
• ? - Show/hide help
• q / Esc - Go back; shows a quit prompt when at the root view
• Q - Quit immediately (no prompt)
• Ctrl+C / :q - Quit (also skips the prompt)

• :ctx <name> - Switch to a different Kubernetes context
• :ctx - Open interactive context selection menu
• :ns <namespace> - Switch namespace
• :ns all - View all namespaces
• :favorites or :fav - View favorite resources
• :events or :ev - Live Kubernetes events feed (current namespace scope)
• :logs [pod] - Stream a Flux controller pod's logs (submenu without argument)
• :skin {skin-name} - set skin directly
• :skin - open interactive theme selection menu with live preview (17 built-in themes + custom)
• :q or :q! - Quit
• :help - Show help

• Graph View (g) - Visualize resource relationships and dependencies. Shows upstream sources and downstream managed resources. Move the highlighted focus between nodes with j/k (the view scrolls to keep it visible), press Enter to open the focused resource's detail view, and Esc to return to the graph. Supported for Kustomization, HelmRelease, ArtifactGenerator, FluxInstance, and ResourceSet.
• History View (h) - View reconciliation history for FluxInstance, ResourceSet, Kustomization, and HelmRelease resources.
• Events View (:events) - Live Kubernetes events feed for the current namespace (or cluster-wide with :ns all), newest first with Warnings highlighted. Enter jumps to the involved resource; the describe view (d) also shows a per-resource Events section.
• Favorites (f) - Mark resources as favorites for quick access. Use :favorites command to view all favorites.

• flux9s config --help - Show the config options
• flux9s config set {KEY} {VALUE} - set a yaml option with the cli.
• config set ui.skinReadOnly rose-pine - set a skin that is in your systems flux9s/skins dir when readonly enabled.
• flux9s config set connectTimeoutSeconds 15 - set the startup Kubernetes API health-check timeout.
• flux9s config set editor vim - set the preferred editor for resource editing (overridden by FLUX9S_EDITOR env var).
• flux9s config skins set navy.yaml - import a skin, validate, set in config.
• flux9s completions zsh - generate shell completions (bash, zsh, fish, elvish, powershell); e.g. flux9s completions zsh > "${fpath[1]}/_flux9s".
• flux9s --version / flux9s version - show the installed version (version also checks for updates).

Note: Not all K9s skins are compatible with flux9s. flux9s skins follow a similar format but may require adjustments to work properly.

This project is inspired by and built with the following excellent tools:

• K9s - The terminal UI for Kubernetes that inspired this project
• Flux - The open and extensible continuous delivery solution for Kubernetes. Powered by GitOps Toolkit.
• kube-rs - The Rust Kubernetes client library powering the Kubernetes API interactions
• kopium - The tool used to generate Rust types from Kubernetes CRDs

AI was used to get the scaffold of this project together, if there are mistakes or issues please open an issue, or a PR!

Contributions are welcome! Please feel free to submit a Pull Request.

This project is licensed under the Apache License, Version 2.0 - see the LICENSE file for details.