mirrord
Run any process, on your machine or in an AI agent's environment, as if it were a pod in your Kubernetes cluster: real env vars, DNS, network, traffic.
mirrord is a Kubernetes development tool that enables Claude Code and other AI coding agents to execute processes as if they were running inside a live Kubernetes cluster. It mirrors environment variables, DNS resolution, network traffic, and file system access from target pods in your cluster to your local process or AI-generated code. This allows AI agents to test and verify code changes against real production-like services and data without requiring actual deployments. The tool is available as a CLI, VS Code extension, and IntelliJ plugin, making it accessible across development environments and AI coding workflows.
Key Features
Use Cases
- 01Testing AI-generated code against real Kubernetes services before committing changes
- 02Debugging microservices locally while connected to production dependencies and databases
- 03Validating API integrations with actual cluster environment variables and network topology
- 04Running AI agent workflows that need access to live queue contents and service responses
- 05Developing features locally while consuming real cluster secrets and configuration
- 06Iterating on code changes with production-like context without lengthy CI/CD cycles
Related Plugins
View moreandrej-karpathy-skills
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
claude-mem
Persistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More
Understand-Anything
Graphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.
rtk
CLI proxy that reduces LLM token consumption by 60-90% on common dev commands. Single Rust binary, zero dependencies
mirrord — FAQ
What is mirrord and how does it work with AI coding agents?+
mirrord connects your local process or AI-generated code to a live Kubernetes pod, mirroring its environment variables, network traffic, DNS, and file system. AI agents like Claude Code can execute and test generated code against real cluster services without deploying, receiving instant feedback on whether changes work end-to-end.
How do I install mirrord for use with Claude Code?+
Install mirrord via Homebrew (brew install metalbear-co/mirrord/mirrord), curl script, Chocolatey on Windows, or Nix. For Claude Code integration, reference the metalbear-co/skills repository for ready-made workflow skills, or use the CLI directly with mirrord exec commands.
Which AI coding clients does mirrord support?+
mirrord works with Claude Code, Cursor, Codex CLI, Gemini CLI, GitHub Copilot, Windsurf, and other AI coding agents. It also integrates with VS Code and IntelliJ as IDE extensions for manual debugging.
What are the prerequisites for using mirrord?+
You need a valid kubeconfig file with access to your Kubernetes cluster. The cluster must allow pods with specific Linux capabilities (CAP_NET_ADMIN, CAP_NET_RAW, CAP_SYS_PTRACE, CAP_SYS_ADMIN), though these can be partially disabled in configuration if needed.
Is mirrord free to use?+
Yes, mirrord is open source and released under the MIT license. The CLI tool, VS Code extension, and IntelliJ plugin are all freely available.
Can mirrord disrupt my production cluster?+
No, mirrord mirrors traffic and context from cluster pods to your local process without modifying the cluster itself. Your code runs locally, and other users or services in the cluster are not affected by your development workflow.
How do I install mirrord?+
Open the source repository on GitHub and follow its README. mirrord is a plugin — MCP Agents Market links you directly to the official repo.
Is mirrord free?+
mirrord is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.