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.
Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add instructions/txn2/kubefwd/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.svg" alt="Measured on agentmods" 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.03958 | $0.03958 |
| Opus 5 | $0.01979 | $0.01979 |
| Sonnet 5 | $0.00792 | $0.00792 |
| Haiku 4.5 | $0.00396 | $0.00396 |
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 6d 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 — 408 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.
- 6d 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,165 stars, last pushed yesterday), licensed Apache-2.0. It adds 3,958 tokens to every session, about $0.0198 per session on Opus 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.
Other instructions, from other repositories
timoni AGENTS.md
AGENTS.md instructions for stefanprodan/timoni, covering agents.md, what timoni is, common commands, architecture and cmd/timoni/ — cli (cobra).
nvcf AGENTS.md
AGENTS.md instructions for NVIDIA/nvcf, covering agents.md - guide for ai coding agents, repo layout, cross-repo and stack routing, oss snapshot hygiene and local qa and testing environment safety.
Kubeli CLAUDE.md
Claude Code instructions for atilladeniz/Kubeli, covering kubeli - kubernetes management desktop app, project overview, quick start, development (tauri + vite) and web only development.
siclaw AGENTS.md
AGENTS.md instructions for scitix/siclaw, covering siclaw project instructions, project shape, before risky edits, verification and stable boundaries.
aks-mcp copilot-instructions.md
Copilot instructions for Azure/aks-mcp, covering copilot instructions, project overview, architecture, high-level structure and key components.
cloud-native-ref CLAUDE.md
Claude Code instructions for Smana/cloud-native-ref, covering claude.md, repository overview, infrastructure architecture, key components and eks bootstrap architecture.