https://github.com/doganarif/k9sight
A fast, keyboard-driven TUI for debugging Kubernetes workloads
https://github.com/doganarif/k9sight
cli debugging devops go k8s kubectl kubernetes terminal tui
Last synced: about 1 month ago
JSON representation
A fast, keyboard-driven TUI for debugging Kubernetes workloads
- Host: GitHub
- URL: https://github.com/doganarif/k9sight
- Owner: doganarif
- License: mit
- Created: 2025-12-03T13:56:22.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2025-12-03T20:41:13.000Z (2 months ago)
- Last Synced: 2025-12-06T18:26:03.253Z (about 2 months ago)
- Topics: cli, debugging, devops, go, k8s, kubectl, kubernetes, terminal, tui
- Language: Go
- Size: 1.38 MB
- Stars: 17
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# k9sight
A fast, keyboard-driven TUI for debugging Kubernetes workloads.
## Features
- Browse deployments, statefulsets, daemonsets, jobs, cronjobs
- View pod logs with search, time filtering, and container selection
- Execute into pods, port-forward, and describe directly from TUI
- Scale and restart workloads
- Monitor events and resource metrics
- Debug helpers for common issues (CrashLoopBackOff, ImagePullBackOff, etc.)
- Vim-style navigation
## Install
**Homebrew:**
```bash
brew install doganarif/tap/k9sight
```
**Go:**
```bash
go install github.com/doganarif/k9sight/cmd/k9sight@latest
```
**From source:**
```bash
git clone https://github.com/doganarif/k9sight.git
cd k9sight
go build -o k9sight ./cmd/k9sight
```
## Usage
```bash
k9sight
```
### Key Bindings
**Navigation**
| Key | Action |
|-----|--------|
| `j/k` | Navigate up/down |
| `enter` | Select |
| `esc` | Back / Close |
| `/` | Search/Filter |
| `n` | Change namespace |
| `t` | Change resource type |
| `?` | Help |
| `q` | Quit |
**Workload Actions**
| Key | Action |
|-----|--------|
| `s` | Scale deployment/statefulset |
| `R` | Restart workload |
**Pod Actions** (in pod view)
| Key | Action |
|-----|--------|
| `a` | Actions menu (exec, port-forward, describe, delete) |
| `y` | Copy kubectl commands |
**Logs Panel**
| Key | Action |
|-----|--------|
| `/` | Search logs |
| `[` `]` | Cycle containers |
| `P` | Previous container logs |
| `T` | Time filter (5m/15m/1h/6h) |
| `f` | Toggle follow |
| `e` | Jump to next error |
**Panels**
| Key | Action |
|-----|--------|
| `1-4` | Focus panel (logs/events/metrics/manifest) |
| `tab` | Next panel |
| `v` | Fullscreen toggle |
## Requirements
- Go 1.21+
- kubectl configured with cluster access
## License
MIT