kubefwd is a command-line tool that forwards many Kubernetes services to a developer’s local computer, so local code can reach cluster services using their service names. It is for developing locally against databases, APIs, authentication services, caches, and other workloads running in Kubernetes. The catalogue add-on provides an MCP integration for operating kubefwd.
Borrowing it
Nothing to install: this file belongs to txn2/kubefwd. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/txn2/kubefwd/master/CLAUDE.mdgit clone --depth 1 https://github.com/txn2/kubefwdWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/instructions/txn2/kubefwd/claude-md)<a href="https://agentmods.dev/instructions/txn2/kubefwd/claude-md"><img src="https://agentmods.dev/badge/instructions/txn2/kubefwd/claude-md/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/instructions/txn2/kubefwd/claude-md"><img src="https://agentmods.dev/badge/instructions/txn2/kubefwd/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.04517 | $0.04517 |
| Opus 5.5 | $0.01807 | $0.01807 |
| Sonnet 5.5 | $0.00903 | $0.00903 |
| Haiku 4.5 | $0.00452 | $0.00452 |
Grade B, and why
kubefwd CLAUDE.md scanned grade B with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 20d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Asks for rootmediumPrivilege escalation
A mod that escalates privileges can change anything on the machine, not only the project.
The typical workflow: `sudo -E kubefwd svc -n <namespace> --tui` runs in a dedicated terminal while developers work in their IDE, accessing cluster services as if running in-cluster. How it starts
The opening of the file, as written. The whole thing — 424 lines — stays where its author put it; the contents beside it link to each section on GitHub.
CLAUDE.md
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
Project Overview
kubefwd is a popular command-line utility for bulk Kubernetes port forwarding, featured in "essential k8s developer tools" lists. It forwards multiple services from one or more namespaces, adding corresponding entries to /etc/hosts for local development.
Key Differentiator from kubectl port-forward: Each service gets its own unique loopback IP address (127.x.x.x), allowing multiple services to use the same port simultaneously (e.g., multiple databases on port 3306, or multiple web services on port 80). This mirrors how services work in the cluster, enabling truly cluster-like local development.
The tool automatically monitors service and pod lifecycle events, starting/stopping port forwards as services are created, deleted, or pods are rescheduled.
Integration and Usage Patterns
kubefwd is commonly integrated into development workflows:
- With Tilt: Blog posts document using kubefwd with Tilt for automated local development setups
- Development Environment Setup: Teams use kubefwd to mirror production-like service topologies locally
- Microservices Development: Allows developers to run one service locally while accessing dependencies in the cluster via service names
- Database Access: Popular for forwarding multiple databases (MySQL, PostgreSQL, MongoDB) on their native ports without port conflicts
The typical workflow: sudo -E kubefwd svc -n <namespace> --tui runs in a dedicated terminal while developers work in their IDE, accessing cluster services as if running in-cluster.
TUI (Terminal User Interface)
kubefwd includes an interactive TUI built with Bubble Tea, enabled with --tui:
sudo -E kubefwd svc -n default --tui
TUI Features
- Real-time service monitoring: See all forwarded services with connection status
- Traffic metrics: Bytes in/out with sparkline graphs
- Pod log streaming: View container logs directly in the TUI
- HTTP activity detection: Monitor HTTP requests/responses flowing through forwards
- Auto-reconnect: Enabled by default in TUI mode, with exponential backoff (1s → 5min max)
- Keyboard-driven: Full keyboard navigation (j/k, Enter, Tab, /, ?, q)
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 20d ago Changed · +16 lines · +559 tokens per session 088decd1ceee
- 2mo ago First seen · 408 lines · 3,958 tokens per session scan B 9be92ccd2911
kubefwd CLAUDE.md is an instructions file published in the GitHub repository txn2/kubefwd (4,179 stars, last pushed 3d ago), licensed Apache-2.0. It adds 4,517 tokens to every session, about $0.0181 per session on Opus 5.5. A static security scan graded it B with 1 finding (asks for root). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
kubefwd CLAUDE.md compared with instructions from other repositories
| Mod | Type | Stars | Last push | Licence | Scan | Tokens | Works with |
|---|---|---|---|---|---|---|---|
| kubefwd CLAUDE.mdtxn2/kubefwd | Instructions file | 4.2k | 3d ago | Apache-2.0 | B | 4,517 | Claude Code |
| vscode buildNext.instructions.mdmicrosoft/vscode | Instructions file | 195k | yesterday | MIT | A | 9,719 | GitHub Copilot |
| next.js AGENTS.mdvercel/next.js | Instructions file | 143k | today | MIT | A | 7,461 | Codex, OpenCode |
| langchain AGENTS.mdlangchain-ai/langchain | Instructions file | 149k | today | MIT | A | 4,680 | Codex, OpenCode |
| vscode oss-third-party-notices.instructions.mdmicrosoft/vscode | Instructions file | 195k | yesterday | MIT | A | 5,516 | GitHub Copilot |
| vscode copilot-instructions.mdmicrosoft/vscode | Instructions file | 195k | yesterday | MIT | A | 3,093 | GitHub Copilot |
| deepseek-harness AGENTS.mddeepseek-ai/deepseek-harness | Instructions file | 274k | 2d ago | MIT | A | 4,313 | Codex, OpenCode |