{"id":13400437,"url":"https://github.com/txn2/kubefwd","last_synced_at":"2026-02-04T20:16:55.736Z","repository":{"id":37391000,"uuid":"143650971","full_name":"txn2/kubefwd","owner":"txn2","description":"Bulk port forwarding Kubernetes services for local development.","archived":false,"fork":false,"pushed_at":"2025-04-16T23:20:53.000Z","size":16386,"stargazers_count":3887,"open_issues_count":29,"forks_count":209,"subscribers_count":32,"default_branch":"master","last_synced_at":"2025-04-23T20:53:11.964Z","etag":null,"topics":["developer-tools","devops","devops-tools","devtools","k8s","kubefwd","kubernetes","kubernetes-clusters","kubernetes-namespace","networking","port-forward","port-forwarding","proxy"],"latest_commit_sha":null,"homepage":"https://imti.co/kubernetes-port-forwarding/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/txn2.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-08-05T22:05:58.000Z","updated_at":"2025-04-23T12:38:56.000Z","dependencies_parsed_at":"2024-10-23T06:15:12.007Z","dependency_job_id":"d4cf77e6-16c2-496b-9747-cb488617f093","html_url":"https://github.com/txn2/kubefwd","commit_stats":{"total_commits":250,"total_committers":46,"mean_commits":5.434782608695652,"dds":0.5920000000000001,"last_synced_commit":"d6a33956a271d5972fb3866e0fae5c93b73b7ebe"},"previous_names":[],"tags_count":70,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/txn2%2Fkubefwd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/txn2%2Fkubefwd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/txn2%2Fkubefwd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/txn2%2Fkubefwd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/txn2","download_url":"https://codeload.github.com/txn2/kubefwd/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250514767,"owners_count":21443208,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["developer-tools","devops","devops-tools","devtools","k8s","kubefwd","kubernetes","kubernetes-clusters","kubernetes-namespace","networking","port-forward","port-forwarding","proxy"],"created_at":"2024-07-30T19:00:52.024Z","updated_at":"2026-02-04T20:16:55.727Z","avatar_url":"https://github.com/txn2.png","language":"Go","funding_links":[],"categories":["Go","Go Tools","Related Software","Software Packages","Productivity Tools","proxy","📦 Containers","Containerised MCP Servers","Developer Workspaces \u0026 Productivity","Cloud Platforms","MCP Clients"],"sub_categories":["DevOps Tools","[Jenkins](#jenkins)","☸️ Kubernetes","DevOps \u0026 Infrastructure","CLI Tools"],"readme":"# kubefwd (Kube Forward)\n\n![kubefwd - kubernetes bulk port forwarding](kubefwd-mast2.jpg)\n\n[![CNCF Landscape](https://img.shields.io/badge/CNCF%20Landscape-5699C6?logo=cncf\u0026logoColor=fff)](https://landscape.cncf.io/?item=app-definition-and-development--application-definition-image-build--kubefwd)\n[![GitHub license](https://img.shields.io/github/license/txn2/kubefwd.svg)](https://github.com/txn2/kubefwd/blob/master/LICENSE)\n[![codecov](https://codecov.io/gh/txn2/kubefwd/branch/master/graph/badge.svg)](https://codecov.io/gh/txn2/kubefwd)\n[![Go Report Card](https://goreportcard.com/badge/github.com/txn2/kubefwd)](https://goreportcard.com/report/github.com/txn2/kubefwd)\n[![GitHub release](https://img.shields.io/github/release/txn2/kubefwd.svg)](https://github.com/txn2/kubefwd/releases)\n[![GitHub Downloads](https://img.shields.io/github/downloads/txn2/kubefwd/total)](https://github.com/txn2/kubefwd/releases)\n[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/txn2/kubefwd/badge)](https://scorecard.dev/viewer/?uri=github.com/txn2/kubefwd)\n[![OpenSSF Best Practices](https://www.bestpractices.dev/projects/11659/badge)](https://www.bestpractices.dev/projects/11659)\n[![SLSA 3](https://slsa.dev/images/gh-badge-level3.svg)](https://slsa.dev)\n\n\n**[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/)**\n\n## Develop Locally, Connect to Kubernetes\n\n**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.\n\nThis 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.\n\n\u003e Bulk Kubernetes port forwarding with an interactive TUI, unique IPs per service, and automatic reconnection.\n\n**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.\n\n![kubefwd TUI - Main View](docs/images/tui-110-main-active.png)\n\n## Quick Start\n\n```bash\n# Install (macOS)\nbrew install kubefwd\n\n# Forward all services in a namespace with the interactive TUI\nsudo -E kubefwd svc -n my-namespace --tui\n```\n\nPress `?` for help, `q` to quit. See [Getting Started](https://kubefwd.com/getting-started/) for detailed installation and setup.\n\n## How It Works\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg width=\"654\" alt=\"kubefwd - Kubernetes Port Forward Diagram\" src=\"https://mk.imti.co/images/content/kubefwd-net.png\"\u003e\n\u003c/div\u003e\n\nkubefwd 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:\n\n```bash\ncurl http://api-service:8080\nmysql -h database -P 3306\nredis-cli -h cache -p 6379\n```\n\n## Features\n\n- **Interactive TUI**: Real-time service monitoring with traffic metrics\n- **Unique IP per Service**: Each service gets its own 127.x.x.x address\n- **Auto-Reconnect**: Reconnects when pods restart or connections drop\n- **Bulk Forwarding**: Forward all services in a namespace with one command\n- **Live Traffic Monitoring**: See bytes in/out and HTTP activity\n- **Pod Log Streaming**: View container logs in the TUI\n- **REST API**: Programmatic control via HTTP endpoints\n- **MCP Support**: Integration with AI assistants (Claude Code, Cursor)\n\n## Installation\n\n**macOS:**\n```bash\nbrew install kubefwd\n```\n\n**Linux:** Download `.deb`, `.rpm`, or `.tar.gz` from [releases](https://github.com/txn2/kubefwd/releases)\n\n**Windows:**\n```powershell\nwinget install txn2.kubefwd\n# or\nscoop install kubefwd\n```\n\n**Docker:**\n```bash\ndocker run -it --rm --privileged \\\n  -v \"$HOME/.kube:/root/.kube:ro\" \\\n  txn2/kubefwd services -n my-namespace --tui\n```\n\n## Usage\n\n```bash\n# Interactive mode (recommended)\nsudo -E kubefwd svc -n default --tui\n\n# Multiple namespaces\nsudo -E kubefwd svc -n default,staging --tui\n\n# Filter by label\nsudo -E kubefwd svc -n default -l app=api --tui\n\n# With REST API enabled\nsudo -E kubefwd svc -n default --tui --api\n```\n\n## Why kubefwd?\n\nUnlike `kubectl port-forward`, kubefwd:\n\n| Feature | kubectl port-forward | kubefwd |\n|---------|---------------------|---------|\n| Services per command | One | All in namespace |\n| IP allocation | localhost only | Unique IP per service |\n| Port conflicts | Manual management | None (unique IPs) |\n| Service name resolution | Not supported | Automatic (/etc/hosts) |\n| Auto-reconnect | No | Yes |\n| Real-time monitoring | No | TUI with metrics |\n\nSee [Comparison](https://kubefwd.com/comparison/) for detailed comparisons with Telepresence, mirrord, and other tools.\n\n## Documentation\n\nFull documentation at **[kubefwd.com](https://kubefwd.com)**:\n\n- [Getting Started](https://kubefwd.com/getting-started/) - Installation and setup\n- [User Guide](https://kubefwd.com/user-guide/) - Interface and shortcuts\n- [Configuration](https://kubefwd.com/configuration/) - CLI options\n- [Advanced Usage](https://kubefwd.com/advanced-usage/) - Multi-cluster, selectors\n- [REST API](https://kubefwd.com/api-reference/) - API reference\n- [MCP Integration](https://kubefwd.com/mcp-integration/) - AI assistant setup\n- [Troubleshooting](https://kubefwd.com/troubleshooting/) - Common issues\n- [Architecture](https://kubefwd.com/architecture/) - Technical details\n- [Comparison](https://kubefwd.com/comparison/) - vs Telepresence, mirrord\n\n## Requirements\n\n- kubectl configured with cluster access\n- Root/sudo access (for /etc/hosts and network interfaces)\n\n## Contributing\n\nWe welcome contributions for bug fixes, tests, and documentation. Feature development is limited to maintainers. See [CONTRIBUTING.md](CONTRIBUTING.md).\n\n## License\n\n[Apache License 2.0](LICENSE)\n\n---\n\nOpen source by [Craig Johnston](https://twitter.com/cjimti), sponsored by [Deasil Works, Inc.](https://deasil.works/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftxn2%2Fkubefwd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftxn2%2Fkubefwd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftxn2%2Fkubefwd/lists"}