Using KFtui

Learn how to effectively use KFtui's terminal interface for managing your Kubernetes port forwards.

Basic Navigation

Keyboard Controls

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

1. Press i to open import menu
2. Navigate to JSON file
3. Select file with Enter

Example configuration:

{
  "service": "web-app",
  "namespace": "default",
  "local_port": 8080,
  "remote_port": 80,
  "protocol": "tcp",
  "alias": "web"
}

Exporting Configurations

1. Press e to export
2. Choose save location
3. Enter filename
4. Press Enter to confirm

Managing Port Forwards

1. Starting Forwards
   • Select configurations with Space
   • Press f to start forwarding
   • Status updates automatically
2. Stopping Forwards
   • Navigate to running config
   • Select with Space
   • Press f to stop
3. Bulk Operations
   • Use Ctrl+A to select all
   • Press f to start/stop
   • Press d to delete

Advanced Features

Auto Import

1. Press Tab for menu
2. Select "Auto Import"
3. Choose context
4. Select configurations
5. Press f to start

Configuration Management

• Use meaningful aliases
• Group related forwards
• Document port usage
• Regular exports

Best Practices

Terminal Setup

1. Size Requirements
   • Minimum 80x24 terminal
   • Larger recommended
   • Resizable window
2. Color Support
   • 256 colors recommended
   • UTF-8 support required
   • Modern terminal emulator

Workflow Tips

1. Efficient Navigation
   • Learn keyboard shortcuts
   • Use bulk operations
   • Organize configurations
2. Remote Usage
   • Use screen/tmux
   • Regular state checks

Troubleshooting

Common Issues

1. Display Problems
   • Check terminal size
   • Verify color support
   • Update terminal
2. Connection Issues
   • Verify cluster access
   • Check service status
   • Review permissions
3. Performance
   • Limit active forwards
   • Monitor resources
   • Regular cleanup

Tips and Tricks

Efficient Usage

1. Quick Selection
   • Use Ctrl+A for all
   • Space for individual
   • Tab for navigation
2. State Management
   • Regular exports
   • Document changes
   • Use auto-import
3. Remote Work
   • Persistent sessions
   • Regular checks