LazyHelm

A terminal UI for browsing and managing Helm charts. Inspired by lazygit and lazydocker.

Demo

Demo updated to version 0.2.2

What it does

Browse Helm repos, explore chart versions, view and edit values files, and compare versions - all in your terminal. No need to remember helm commands or manually fetch values.

Features

• Intuitive menu system - Main menu with organized sections for browsing and future cluster management
• Interactive browsing of Helm repositories and charts
• Search and browse Artifact Hub directly from the UI
• Add repositories from Artifact Hub with package info and security reports
• Update repository indexes - Keep your local chart indexes up to date with helm repo update
• Syntax-highlighted YAML viewing
• Edit values in your preferred editor (nvim/vim/vi/etc)
• Compare values between versions with diff view
• Fuzzy search and filtering with quick clear
• Copy YAML paths to clipboard
• Export values to files
• Template generation preview
• Repository management (add/remove/update)

Installation

Homebrew

brew tap alessandropitocchi/lazyhelm
brew install lazyhelm

Or in one command:

brew install alessandropitocchi/lazyhelm/lazyhelm

Install script

curl -sSL https://raw.githubusercontent.com/alessandropitocchi/lazyhelm/main/install.sh | bash

From source

git clone https://github.com/alessandropitocchi/lazyhelm.git
cd lazyhelm
make install

Usage

Just run:

lazyhelm

Set your editor if you want (defaults to nvim → vim → vi):

export EDITOR=nvim

Menu Structure

LazyHelm uses an intuitive menu system to organize functionality:

Main Menu
├── Browse Repositories
│   ├── Local Repositories - Browse your configured Helm repos
│   └── Search Artifact Hub - Search charts on Artifact Hub
├── Cluster Releases (Coming Soon) - Manage deployed releases
└── Settings (Coming Soon) - Configure LazyHelm

Keybindings

Navigation

• ↑/k, ↓/j - Move up/down
• ←/h, →/l - Scroll left/right (in values view)
• enter - Select item / Go deeper
• esc - Go back to previous screen
• q - Quit application
• ? - Toggle help screen

Search & Filter

• / - Search/filter in current view
• c - Clear search filter
• n - Next search result
• N - Previous search result

Repository Management

• a - Add new repository
• r - Remove selected repository
• u - Update repository index (helm repo update)
• s - Search Artifact Hub

Chart & Version Actions

• v - View all versions (in chart list)
• d - Diff two versions (select first, then second)

Values View

• e - Edit values in external editor ($EDITOR)
• w - Write/export values to file
• t - Generate Helm template
• y - Copy YAML path to clipboard
• ←/→, h/l - Scroll horizontally for long lines

How it works

Uses the Helm SDK to interact with chart repos and the Bubbletea framework for the TUI.

Reads from your existing Helm config (~/.config/helm/repositories.yaml) and caches data locally for faster browsing.

Requirements

• Helm 3.x installed
• Go 1.21+ (if building from source)
• Terminal with ANSI color support

Development

git clone https://github.com/alessandropitocchi/lazyhelm.git
cd lazyhelm
go mod download
go build -o lazyhelm ./cmd/lazyhelm
./lazyhelm

TODO

• Helm operations (install/upgrade/uninstall)
• Show deployed releases from K8s (Cluster Releases menu)
• Config file
• Bookmarks

License

Licensed under the Apache License, Version 2.0 - see the LICENSE file for details.

Copyright 2025 Alessandro Pitocchi