Kubesnap: Improved kubernetes context & namespace management tool.

kubesnap is a TUI tool that provides an instant cluster status overview and fast switching between cluster contexts/namespaces, offering a streamlined way to manage your Kubernetes environment.

Features

• Cluster Dashboard: Real-time overview of current connection and resource status (Nodes, Pods, Events).
• Context Switching: Fast, fuzzy-searchable cluster context selector.
• Edit Contexts: Rename or Delete contexts directly within the TUI.
• Namespace Switching: Interactive namespace switcher with a kubesnap ns ~ shortcut for default namespace.

Get Started

Homebrew (macOS & Linux)

brew install hunsy9/kubesnap/kubesnap

Shell Script (Unix-like)

curl -sfL https://raw.githubusercontent.com/hunsy9/kubesnap/main/install.sh | sh

Scoop (Windows)

scoop bucket add hunsy9 https://github.com/hunsy9/scoop-bucket
scoop install kubesnap

Usage

💡 Tip: We recommend aliasing kubesnap to ks for speed.

Add this to your shell config (.bashrc, .zshrc, etc.):

alias ks='kubesnap'

1. Cluster Overview

View current cluster connection and health overview.

$ kubesnap

2. Switch/Rename/Delete Context

Open the interactive context switcher and edit your context.

$ kubesnap ctx

• Enter: Switch to the selected context.
• r key: Rename the selected context.
• d key: Move to context deletion mode.

3. Switch Namespace

Open the interactive namespace switcher

$ kubesnap ns
# or switch to default
$ kubesnap ns ~

Key Bindings

• ↑ / ↓: Navigate list
• /: Search / Filter
• Enter: Select item
• r: Rename context
• d: Delete context
• q / Esc: Quit / Cancel

Maintenance

Update

Run the install script again or use the following commands:

• Homebrew: brew upgrade kubesnap
• Scoop: scoop update kubesnap

Uninstallation

# Via Homebrew
brew uninstall kubesnap

# Via Script
curl -sfL https://raw.githubusercontent.com/hunsy9/kubesnap/main/uninstall.sh | sh

# Via Scoop
scoop uninstall kubesnap

---

Created by Seunghun using Bubble Tea.