Using KFtui
Learn how to effectively use KFtui's terminal interface for managing your Kubernetes port forwards.
Basic Navigation
Keyboard Controls
Key | Action |
---|---|
โ/โ | Navigate list |
โ/โ | Switch tables |
Tab | Switch focus |
Space | Select item |
Ctrl+A | Select all |
f | Forward ports |
h | Help menu |
q | Quit |
Interface Sections
โโ Menu โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ [Import] [Export] [Auto-Import] [Help] โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ Running Configurations โ
โ โก web-app 8080:80 default Running โ
โ โก database 5432:5432 data Stopped โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
Managing Configurations
Importing Configurations
- Press
i
to open import menu - Navigate to JSON file
- Select file with
Enter
Example configuration:
{
"service": "web-app",
"namespace": "default",
"local_port": 8080,
"remote_port": 80,
"protocol": "tcp",
"alias": "web"
}
Exporting Configurations
- Press
e
to export - Choose save location
- Enter filename
- Press
Enter
to confirm
Managing Port Forwards
- Starting Forwards
- Select configurations with
Space
- Press
f
to start forwarding - Status updates automatically
- Select configurations with
- Stopping Forwards
- Navigate to running config
- Select with
Space
- Press
f
to stop
- Bulk Operations
- Use
Ctrl+A
to select all - Press
f
to start/stop - Press
d
to delete
- Use
Advanced Features
Auto Import
- Press
Tab
for menu - Select "Auto Import"
- Choose context
- Select configurations
- Press
f
to start
Configuration Management
- Use meaningful aliases
- Group related forwards
- Document port usage
- Regular exports
Best Practices
Terminal Setup
- Size Requirements
- Minimum 80x24 terminal
- Larger recommended
- Resizable window
- Color Support
- 256 colors recommended
- UTF-8 support required
- Modern terminal emulator
Workflow Tips
- Efficient Navigation
- Learn keyboard shortcuts
- Use bulk operations
- Organize configurations
- Remote Usage
- Use screen/tmux
- Regular state checks
Troubleshooting
Common Issues
- Display Problems
- Check terminal size
- Verify color support
- Update terminal
- Connection Issues
- Verify cluster access
- Check service status
- Review permissions
- Performance
- Limit active forwards
- Monitor resources
- Regular cleanup
Tips and Tricks
Efficient Usage
- Quick Selection
- Use
Ctrl+A
for all - Space for individual
- Tab for navigation
- Use
- State Management
- Regular exports
- Document changes
- Use auto-import
- Remote Work
- Persistent sessions
- Regular checks
Table of Contents