Blazing-fast TUI for Kubernetes contexts with AI natural language, EKS kubeconfig sync, and AWS SSO management. Available for macOS and Linux.
Quick Start
Available via Homebrew. No dependencies to manage manually.
Homebrew 6+ requires you to trust third-party taps once before installing from them (brew trust).
To upgrade: brew upgrade ksw
Or install with a single command (macOS & Linux):
Detects your OS and architecture automatically. · All releases →
Why ksw?
Available for macOS and Linux (amd64 & arm64). Designed for engineers who manage dozens of Kubernetes clusters daily.
Type any part of a context name and instantly filter results with intelligent fuzzy matching and scoring.
Use ksw payments-dev instead of the full ARN. ksw resolves it automatically.
Create memorable shortcuts for your most-used contexts. ksw @prod gets you there instantly.
Pin your most-used contexts to always appear at the top. Use Ctrl+P in the TUI to pin/unpin instantly.
Organize contexts into named groups. ksw group use payments opens the TUI filtered to only your payments contexts.
ksw - switches back to the last context instantly — like cd - in bash.
ksw history shows your last 10 contexts. Jump to any entry with ksw history 3.
Your current context is always highlighted in green in the list, so you never lose track of where you are.
Navigate hundreds of contexts with keyboard shortcuts. The cursor always stays visible on screen.
Use ksw -l to list contexts in scripts and CI pipelines without launching the TUI.
List, kubectx-style, columns, grouped, tree, region, matrix, cards, grid and split. Press Ctrl+V to pick one — it is remembered.
dev / qa / pdn / prod / sbx / lab detected from the name, production in red, plus the AWS profile and account of the selected cluster.
Ctrl+H toggles eks-payments-dev ↔ the full ARN in every view. Ctrl+A/Ctrl+E jump to top/bottom.
After a sync you see exactly which accounts and clusters were added: profile, account ID and cluster, grouped per account.
Accounts that disappeared from AWS SSO are detected, and you can remove their profiles and kubeconfig clusters — with confirmation and a backup.
Exact-ARN matching, the right SSO token per session, automatic retries on transient AWS CLI errors and a progress bar that tells the truth.
Cluster views
11 views one keystroke away. Environment-aware, with the AWS profile of every account — all derived locally from your kubeconfig.
Press Ctrl+V in ksw to switch. Your choice is remembered.
🤖 AI-Powered
Stop memorizing ARNs and commands. Just tell ksw what you need in plain language.
Switch contexts, create groups, pin favorites, list aliases — describe it in your own words and the AI executes it. No syntax to memorize.
The AI remembers your last 10 interactions. Say "go back to the previous one" or "same but in qa" and it understands the context.
Execute multiple tasks in a single prompt. "List my pins and groups" runs both commands and returns combined results.
Works with OpenAI, Claude (Anthropic), Gemini (Google) and AWS Bedrock. Use the model you already have access to.
Ask for tables, summaries, or any custom format. The AI builds the response from your actual state — not canned output.
ksw ai chat opens a full-screen conversational TUI. Multi-turn dialogue with your clusters — type, get answers, keep going.
The AI knows your current context, all groups, pins, aliases and history. It gives personalized, accurate answers every time.
ksw ai "why is my pod crashing?" — the AI runs kubectl commands (get pods, describe, logs, events, top) and analyzes the output to diagnose issues in natural language.
ksw eks kubeconfig sync reads your AWS profiles, discovers clusters in parallel with a live progress bar, and adds missing ones to kubeconfig automatically. Filter by profile with --profile.
ksw eks config opens an interactive manager: sync all profiles, sync a specific profile with live search, view clusters in kubeconfig, remove stale entries, or wipe everything — all with real-time streaming progress.
ksw k8s — browse pods, deployments, services and more with live CPU/MEM metrics, semantic coloring, horizontal scroll, multi-select delete, label-based aggregated logs and namespace switching.
ksw aws sso config — manage SSO sessions, login, auto-sync all accounts and roles to ~/.aws/config with live progress. Fully free.
ksw is free and open source. If it saves you time, consider sponsoring to keep it growing.
Get priority responses to issues and questions directly from the creator. Your problems get solved first.
Request features and get them prioritized. Sponsors shape what gets built next.
Your contribution keeps ksw free and open source for everyone. No paywalls, no feature locks.
Examples
From interactive navigation to AI natural language, ksw fits every workflow.