Home

kubefwd enables developers to work locally while accessing services running in Kubernetes. Connect to db:5432, auth:443, redis:6379, all by service name, exactly as in-cluster. No environment config, no Docker Compose. Just run kubefwd.

Get Started GitHub

Four Ways to Use kubefwd¶

TUIClassicREST APIMCP

Interactive terminal interface with real-time monitoring.

sudo -E kubefwd svc -n my-namespace --tui

Real-time service status and traffic metrics
Pod log streaming
Keyboard-driven navigation
TUI Guide →

Simple log output for scripts and automation.

sudo -E kubefwd svc -n my-namespace

Minimal output, logs to stdout
Perfect for CI/CD and scripts
Getting Started →

Programmatic control via HTTP endpoints.

sudo -E kubefwd  # Idle mode, API enabled
curl http://kubefwd.internal/api/v1/services

Add/remove namespaces and services dynamically
Query metrics and diagnostics
SSE event streaming
REST API →

Talk to your AI about your work, not about tools.

# Add to Claude Code
claude mcp add --transport stdio kubefwd -- kubefwd mcp

"Connect me to the staging database"
"Test my new API deployment"
"Why can't my app reach redis?"
MCP Integration →

🔌

Unique IP per Service Each service gets its own 127.x.x.x. Multiple databases on port 3306? No conflicts.

🔄

Auto-Reconnect Pods restart? kubefwd reconnects automatically with exponential backoff.

📊

Interactive TUI Real-time status, traffic metrics, and pod logs in your terminal.

🌐

Service Names Work Updates /etc/hosts so any app can access services by name.

# macOS
brew install txn2/tap/kubefwd

# Then forward services
sudo -E kubefwd svc -n my-namespace --tui