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.
What is 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.
Overview of mirrord
What it is
mirrord runs your local process inside a live Kubernetes cluster. It works the same way for developers and for AI coding agents (Claude Code, Cursor, Codex, Copilot, Windsurf): your code runs on your machine, but mirrord routes its traffic, files, and environment variables through a target pod in the cluster.
Key features
- Runs any local process as if it were a pod in your Kubernetes cluster: real env vars, DNS, network, traffic.
- Ships as a VS Code extension, IntelliJ plugin, and CLI tool.
- Works with AI coding agents (Claude Code, Cursor, Codex CLI, Gemini CLI, and others).
- Mirrors incoming traffic from the impersonated pod to your local process.
- Routes outgoing traffic from your local process through the pod.
- Handles file reads, file writes, and environment variables from the target pod.
- Requires Linux capabilities (CAP_NET_ADMIN, CAP_NET_RAW, CAP_SYS_PTRACE, CAP_SYS_ADMIN) which can be disabled via configuration.
Use cases
- Developers debugging a local process against a live Kubernetes cluster without deploying.
- AI coding agents running and verifying generated code against real cluster services.
- Reading live cluster context (env vars, service responses, queue contents) while writing code.
- Running code against the same services and data to confirm end-to-end functionality.
- Getting feedback of a deploy in seconds without disrupting the cluster for others.
Getting started
Install via Homebrew: sh brew install metalbear-co/mirrord/mirrord Or via curl: sh curl -fsSL https://raw.githubusercontent.com/metalbear-co/mirrord/main/scripts/install.sh | bash Or using Nix (community maintained): sh nix profile install nixpkgs#mirrord Or on Windows using Chocolatey: sh choco install --pre mirrord Use the CLI: sh mirrord exec --target Example: sh mirrord exec node app.js --target pod/my-pod For VS Code and IntelliJ, see the repository README for installation and usage.
License and pricing
The project is licensed under MIT and is open source.
Based on the project's public README and repository metadata.
