A keyboard-driven terminal UI for Talos Linux clusters.

Installation · Features · Keybindings · Configuration · License

lazytalos is a fast, keyboard-first TUI for managing Talos Linux clusters from the terminal. It follows the "lazy" convention (lazygit, lazydocker, lazystack) to provide an intuitive alternative to talosctl and the built-in Talos dashboard.

Single binary. No runtime dependencies. Reads your standard talosconfig.

• Cluster dashboard -- dot-matrix node health overview, service status matrix, diagnostics, and event stream across all nodes
• Node management -- list all nodes with type, version, health, CPU, memory bars, and uptime; bulk-select with Space for multi-node operations; detail view with live log streaming
• Service management -- flat or group-by-node service listing with state, health, and event history; restart services with confirmation
• Multi-node log viewer -- merged streaming logs from multiple nodes and services simultaneously, with per-node color coding and follow mode
• Container view -- running containers across all nodes
• Network view -- network interfaces, addresses, and routes per node
• Storage view -- disk and volume information per node
• etcd view -- etcd cluster member listing with health and leader status
• Cluster upgrade wizard -- rolling upgrade with pause/abort, health checks between nodes
• Context picker -- read all contexts from talosconfig; auto-connect when only one exists, or pick interactively
• Settings overlay (Ctrl+K) -- configure refresh interval, colors, thresholds, keybindings; persisted to ~/.config/lazytalos/config.yaml
• Configurable thresholds -- memory warning/critical and CPU warning percentages for bar coloring
• Auto-update check -- checks GitHub for new releases (configurable interval, cached to disk)
• Destructive-op safety -- reboot, shutdown, reset, and service restart require confirmation modals; control plane nodes trigger extra warnings
• Auto-refresh -- all views refresh in the background at a configurable interval

Grab the latest release for your platform from the releases page.

sudo dpkg -i lazytalos_*.deb

sudo rpm -i lazytalos-*.rpm

sudo pacman -U lazytalos-*.pkg.tar.zst

cd src
make build

go install github.com/larkly/lazytalos/cmd/lazytalos@latest

• Go 1.24+ (build only)
• A Talos Linux cluster (v1.x+)
• A valid talosconfig

lazytalos reads talosconfig from these locations (first match wins):

1. --talosconfig flag
2. $TALOSCONFIG environment variable
3. ~/.talos/config

No additional configuration is needed. If only one context is defined, lazytalos connects automatically.

Press Ctrl+K to open the settings overlay. Changes are applied immediately and saved to ~/.config/lazytalos/config.yaml. Categories:

• General -- refresh interval, plain mode, update checking
• Thresholds -- memory warning/critical %, CPU warning % (controls bar and dot-matrix coloring)
• Colors -- full Solarized Dark palette customization with hex colors and live preview
• Keybindings -- press-to-bind key remapping

CLI flags override the config file.

Built with:

• Bubble Tea v2 -- TUI framework
• Lip Gloss v2 -- styling
• Bubbles v2 -- UI components
• Talos machinery -- official Talos gRPC client

src/internal/
  app/            # Root model, routing, actions, rendering
  config/         # App settings (config.yaml) + Talos config helpers
  talos/          # Talos gRPC client wrapper, context management
  cluster/        # Cluster-wide queries (members, health, targets)
  node/           # Per-node helpers (containers, etc.)
  etcd/           # etcd member queries and management
  upgrade/        # Rolling upgrade orchestration
  resources/      # COSI resource helpers (CPU, memory, diagnostics)
  update/         # Self-update check with GitHub API + disk cache
  shared/         # Keys, styles, messages, thresholds, debug logging
  ui/
    contextpicker/  # Context selection modal
    dashboard/      # Cluster health dashboard with dot matrix
    nodelist/       # Node list with detail view + live logs
    servicelist/    # Service list with grouping
    logviewer/      # Multi-node log streaming
    containers/     # Container listing and detail
    network/        # Network interfaces and routes (per-node sub-tabs)
    storage/        # Disk and volume info (per-node sub-tabs)
    etcdview/       # etcd cluster members (per-node sub-tabs)
    settings/       # Settings overlay (Ctrl+K)
    configview/     # Talosconfig context viewer
    configeditor/   # Node config YAML editor
    upgrade/        # Cluster upgrade wizard
    help/           # Help overlay
    modal/          # Confirm, error, and reset dialogs
    statusbar/      # Bottom status bar

Apache 2.0