Terminal UI Guide
The KubeGraf terminal UI provides a fast, keyboard-driven interface for managing Kubernetes clusters.
Inspired by vim, it's designed for engineers who prefer staying in the terminal.
Launching the TUI
kubegraf
The TUI automatically connects to your current kubectl context.
Navigation
| Key | Action |
|---|
| j / ↓ | Move down |
| k / ↑ | Move up |
| g | Go to top |
| G | Go to bottom |
| Ctrl+d | Page down |
| Ctrl+u | Page up |
| Tab | Next tab |
| Shift+Tab | Previous tab |
| 1-9 | Jump to tab by number |
Resource Tabs
Switch between resource types using Tab or number keys:
| Key | Resource |
|---|
| 1 | Pods |
| 2 | Deployments |
| 3 | Services |
| 4 | Ingresses |
| 5 | ConfigMaps |
| 6 | Secrets |
| 7 | Nodes |
Actions
| Key | Action |
|---|
| Enter | View resource details / YAML |
| l | View logs (pods only) |
| s | Shell into container |
| d | Describe resource |
| e | Edit resource (opens $EDITOR) |
| y | Copy resource YAML to clipboard |
| Delete | Delete resource (with confirmation) |
Filtering & Search
| Key | Action |
|---|
| / | Start search/filter |
| Esc | Clear filter |
| n | Change namespace |
| c | Change context/cluster |
Workload Operations
| Key | Action |
|---|
| R | Restart deployment/statefulset (rollout restart) |
| S | Scale replicas |
| p | Port forward |
General
| Key | Action |
|---|
| r | Refresh |
| ? | Show help / all keybindings |
| : | Command mode |
| q | Quit |
Pro tip: Press ? at any time to see context-sensitive keybindings for the current view.
Log Viewer
When viewing logs (l on a pod):
| Key | Action |
|---|
| f | Toggle follow mode |
| w | Toggle line wrap |
| / | Search in logs |
| n | Next search match |
| N | Previous search match |
| t | Toggle timestamps |
| Esc / q | Exit log viewer |
Customization
You can customize keybindings in the configuration file. See Configuration for details.