Using KFtui

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

Basic Navigation

Keyboard Controls

KeyAction
โ†‘/โ†“Navigate list
โ†/โ†’Switch tables
TabSwitch focus
SpaceSelect item
Ctrl+ASelect all
fForward ports
hHelp menu
qQuit

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