Skip to content
Back to search

kubefwd

Bulk port forwarding Kubernetes services for local development.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/txn2/kubefwd with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/txn2/kubefwd'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/txn2--kubefwd/badge.svg)](/listings/txn2--kubefwd)

HTML

<a href="/listings/txn2--kubefwd"><img src="/api/listings/txn2--kubefwd/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

# Install (macOS)
brew install kubefwd

# Forward all services in a namespace with the interactive TUI
sudo -E kubefwd svc -n my-namespace --tui

Press `?` for help, `q` to quit. See [Getting Started](https://kubefwd.com/getting-started/) for detailed installation and setup.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 150 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # kubefwd (Kube Forward)
  2. ![kubefwd - kubernetes bulk port forwarding](kubefwd-mast2.jpg)
  3. [![CNCF Landscape](https://img.shields.io/badge/CNCF%20Landscape-5699C6?logo=cncf&logoColor=fff)](https://landscape.cncf.io/?item=app-definition-and-development--application-definition-image-build--kubefwd)
  4. [![GitHub license](https://img.shields.io/github/license/txn2/kubefwd.svg)](https://github.com/txn2/kubefwd/blob/master/LICENSE)
  5. [![codecov](https://codecov.io/gh/txn2/kubefwd/branch/master/graph/badge.svg)](https://codecov.io/gh/txn2/kubefwd)
  6. [![Go Report Card](https://goreportcard.com/badge/github.com/txn2/kubefwd)](https://goreportcard.com/report/github.com/txn2/kubefwd)
  7. [![GitHub release](https://img.shields.io/github/release/txn2/kubefwd.svg)](https://github.com/txn2/kubefwd/releases)
  8. [![GitHub Downloads](https://img.shields.io/github/downloads/txn2/kubefwd/total)](https://github.com/txn2/kubefwd/releases)
  9. [![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/txn2/kubefwd/badge)](https://scorecard.dev/viewer/?uri=github.com/txn2/kubefwd)
  10. [![OpenSSF Best Practices](https://www.bestpractices.dev/projects/11659/badge)](https://www.bestpractices.dev/projects/11659)
  11. [![SLSA 3](https://slsa.dev/images/gh-badge-level3.svg)](https://slsa.dev)
  12. **[Documentation](https://kubefwd.com)** | **[Getting Started](https://kubefwd.com/getting-started/)** | **[User Guide](https://kubefwd.com/user-guide/)** | **[API Reference](https://kubefwd.com/api-reference/)** | **[MCP (AI Integration)](https://kubefwd.com/mcp-integration/)**
  13. ## Develop Locally, Connect to Kubernetes
  14. **kubefwd** enables developers to work on their local machine while seamlessly accessing services running in a Kubernetes cluster. If you're building a new API that needs to connect to a database at `db:5432`, an auth service at `auth:443`, and a cache at `redis:6379`, all running in your development cluster, kubefwd makes them available locally by their service names, exactly as they would appear in-cluster. No environment-specific configuration, no local service setup, no Docker Compose files. Just run `kubefwd` and your application's existing connection strings work.
  15. This is the essential use case: **reduce or eliminate environment-specific connection setup and configurations** during local development. Your code uses `http://api-gateway:8080` in production? It works the same way on your laptop with kubefwd.
  16. > Bulk Kubernetes port forwarding with an interactive TUI, unique IPs per service, and automatic reconnection.
  17. **kubefwd** is a command-line utility that bulk port forwards Kubernetes services to your local workstation. Each service gets its own unique loopback IP (127.x.x.x), eliminating port conflicts and enabling realistic local development with cluster services accessible by name.
  18. ![kubefwd TUI - Main View](docs/images/tui-110-main-active.png)
  19. ## Quick Start
  20. ```bash
  21. # Install (macOS)
  22. brew install kubefwd
  23. # Forward all services in a namespace with the interactive TUI
  24. sudo -E kubefwd svc -n my-namespace --tui
  25. ```
  26. Press `?` for help, `q` to quit. See [Getting Started](https://kubefwd.com/getting-started/) for detailed installation and setup.
  27. ## How It Works
  28. <div align="center">
  29. <img width="654" alt="kubefwd - Kubernetes Port Forward Diagram" src="https://mk.imti.co/images/content/kubefwd-net.png">
  30. </div>
  31. kubefwd discovers services in your namespace, assigns each a unique loopback IP, updates `/etc/hosts` with service names, and establishes port forwards through the Kubernetes API. Access services by name just like in-cluster:
  32. ```bash
  33. curl http://api-service:8080
  34. mysql -h database -P 3306
  35. redis-cli -h cache -p 6379
  36. ```
  37. ## Features
  38. - **Interactive TUI**: Real-time service monitoring with traffic metrics
  39. - **Unique IP per Service**: Each service gets its own 127.x.x.x address
  40. - **Auto-Reconnect**: Reconnects when pods restart or connections drop
  41. - **Bulk Forwarding**: Forward all services in a namespace with one command
  42. - **Live Traffic Monitoring**: See bytes in/out and HTTP activity
  43. - **Pod Log Streaming**: View container logs in the TUI
  44. - **REST API**: Programmatic control via HTTP endpoints
  45. - **MCP Support**: Integration with AI assistants (Claude Code, Cursor)
  46. ## Installation
  47. **macOS:**
  48. ```bash
  49. brew install kubefwd
  50. ```
  51. **Linux:** Download `.deb`, `.rpm`, or `.tar.gz` from [releases](https://github.com/txn2/kubefwd/releases)
  52. **Windows:**
  53. ```powershell
  54. winget install txn2.kubefwd
  55. # or
  56. scoop install kubefwd
  57. ```
  58. **Docker:**
  59. ```bash
  60. docker run -it --rm --privileged \
  61. -v "$HOME/.kube:/root/.kube:ro" \
  62. txn2/kubefwd services -n my-namespace --tui
  63. ```
  64. ## Usage
  65. ```bash
  66. # Interactive mode (recommended)
  67. sudo -E kubefwd svc -n default --tui
  68. # Multiple namespaces
  69. sudo -E kubefwd svc -n default,staging --tui
  70. # Filter by label
  71. sudo -E kubefwd svc -n default -l app=api --tui
  72. # With REST API enabled
  73. sudo -E kubefwd svc -n default --tui --api
  74. ```
  75. ## Why kubefwd?
  76. Unlike `kubectl port-forward`, kubefwd:
  77. | Feature | kubectl port-forward | kubefwd |
  78. |---------|---------------------|---------|
  79. | Services per command | One | All in namespace |
  80. | IP allocation | localhost only | Unique IP per service |
  81. | Port conflicts | Manual management | None (unique IPs) |
  82. | Service name resolution | Not supported | Automatic (/etc/hosts) |
  83. | Auto-reconnect | No | Yes |
  84. | Real-time monitoring | No | TUI with metrics |
  85. See [Comparison](https://kubefwd.com/comparison/) for detailed comparisons with Telepresence, mirrord, and other tools.
  86. ## Documentation
  87. Full documentation at **[kubefwd.com](https://kubefwd.com)**:
  88. - [Getting Started](https://kubefwd.com/getting-started/) - Installation and setup
  89. - [User Guide](https://kubefwd.com/user-guide/) - Interface and shortcuts
  90. - [Configuration](https://kubefwd.com/configuration/) - CLI options
  91. - [Advanced Usage](https://kubefwd.com/advanced-usage/) - Multi-cluster, selectors
  92. - [REST API](https://kubefwd.com/api-reference/) - API reference
  93. - [MCP Integration](https://kubefwd.com/mcp-integration/) - AI assistant setup
  94. - [Troubleshooting](https://kubefwd.com/troubleshooting/) - Common issues
  95. - [Architecture](https://kubefwd.com/architecture/) - Technical details
  96. - [Comparison](https://kubefwd.com/comparison/) - vs Telepresence, mirrord
  97. ## Requirements
  98. - kubectl configured with cluster access
  99. - Root/sudo access (for /etc/hosts and network interfaces)
  100. ## Contributing
  101. We welcome contributions for bug fixes, tests, and documentation. Feature development is limited to maintainers. See [CONTRIBUTING.md](CONTRIBUTING.md).
  102. ## License
  103. [Apache License 2.0](LICENSE)
  104. ---
  105. Open source by [Craig Johnston](https://twitter.com/cjimti), sponsored by [Deasil Works, Inc.](https://deasil.works/)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.