metalbear-coDeveloper tools

mirrord

A developer tool that routes a local process through a Kubernetes pod so code can use live cluster traffic, files, and environment variables without deploying first.

  • Backend
  • DevOps
  • Testing
  • AI coding
  • CLI
  • IDE plugin
  • Windows
  • macOS
  • Linux
  • Runs locally
  • Docker supported
mirrord screenshot
Popularity
5.4k Stars
GitHub stars
Recent activity
10/3/2026
Updated in the last 30 days
License
MIT
Permissive

Why it matters

We look beyond stars: what problem it solves, whether it creates real utility, and what makes its approach worth noticing.

Last 90 days

Problem

In Kubernetes and microservice systems, local code lacks real environment variables, service responses, queues, and network context; repeatedly deploying just to test a change slows feedback and disturbs shared environments.

Practical value

mirrord keeps the process local while routing traffic, files, and environment variables through a target pod, enabling near-live-cluster development and end-to-end validation before deploying a new build.

Innovation / differentiation

Instead of recreating a microservice stack locally, it separates the local process from its runtime context and reconnects them: compute stays on the workstation while dependencies and environment context come from a live pod.

Leverage potential

CLI, VS Code, and IntelliJ integrations fit existing workflows, while AI coding agents can also use real cluster context for implementation and verification, making it a reusable debugging layer for cloud-native development.

Why now

Cloud-native systems are increasingly hard to reproduce locally, while AI coding agents need real runtime context to avoid reasoning only from source code, increasing the value of deployment-free debugging.

Community activity

In the last 90 days there were 9 new issues and 492 pull requests; the bounded issue/PR samples include 9 issue authors and 17 PR contributors, with at least 41 releases.

Maintainer responsiveness

The 9-issue window sample had a 89% close rate, and the 99-pull-request sample had a 78% merge rate. Maintainer-comment observations covered only 22% of that issue sample, so response rate and first-response speed are not reported.

17 contributors in PR sampleAt least 41 releasesPR merge rate 78% · 99 sampled in window

Key highlights

  • Route local incoming and outgoing traffic through a selected pod
  • Use target-context files and environment variables from the local process
  • Work through VS Code, IntelliJ, or the CLI

Quick start

How it is installed, how hard it is, and where to start.

Where it runs

Runs locally

Difficulty

Medium — some setup needed

Docker supportedRuns locally
  1. 01Confirm that the local kubeconfig can access the Kubernetes cluster you want to debug against.
  2. 02Install the VS Code or IntelliJ plugin, or install the mirrord CLI through Homebrew, the install script, or Chocolatey.
  3. 03Choose the namespace and pod to impersonate; with the CLI use mirrord exec --target .
  4. 04Start the local process and verify its interaction with cluster services without deploying a new image.

Best for

  • Developers who want to try it on their machine
  • People who prefer Docker deploys

More about it

mirrord connects a local development process to a live Kubernetes environment. The code continues running on the developer machine, but after selecting a target pod the local process can use that pod’s incoming and outgoing traffic, file access, and environment variables so it interacts with real cluster services and data.

It is available as a VS Code extension, IntelliJ plugin, and CLI. When a pod is selected, mirrord starts a helper pod on the same node and connects the local process to the target environment. This allows developers to test local changes without first building and deploying a new image.

The project also documents workflows for AI coding agents including Claude Code, Cursor, Codex CLI, and Gemini CLI, allowing generated code to be verified against real cluster services. A local kubeconfig with suitable Kubernetes API access is required.

Sources

Each field shows its status and source — expand to review.

14 · Expand
  • capability tags

    Verified

    testing, ai_coding

    Source: manual_curated · Manually curated from the verified project README; no AI draft. · 8/17/2026

  • editor note

    Verified

    {"en":"mirrord is for a specific development loop: change code locally, validate it against real cluster dependencies, and avoid a full build-and-deploy cycle each time. That is useful for microservice debugging and AI coding agents, but access to live pod context means permissions and target environments should be chosen carefully.","zh":"mirrord 的使用场景很具体:本地改代码,但希望拿真实集群依赖来验证,又不想每次都走构建部署。它对微服务调试和 AI 编程 Agent 都有价值,但因为会接入真实 Pod 上下文,权限和目标环境需要谨慎选择。"}

    Source: manual_curated · Manually curated from the verified project README; no AI draft. · 8/17/2026

  • how to use

    Verified

    {"steps":[{"en":"Confirm that the local kubeconfig can access the Kubernetes cluster you want to debug against.","zh":"确认本机 kubeconfig 可以访问需要调试的 Kubernetes 集群。"},{"en":"Install the VS Code or IntelliJ plugin, or install the mirrord CLI through Homebrew, the install script, or Chocolatey.","zh":"安装 VS Code/IntelliJ 插件,或通过 Homebrew、安装脚本、Chocolatey 安装 mirrord CLI。"},{"en":"Choose the namespace and pod to impersonate; with the CLI use `mirrord exec <command> --target <target>`.","zh":"选择需要模拟的命名空间和 Pod;CLI 可使用 `mirrord exec <command> --target <target>`。"},{"en":"Start the local process and verify its interaction with cluster services without deploying a new image.","zh":"启动本地进程,在不部署新镜像的情况下验证它与集群服务的交互。"}],"installAt":"local","difficulty":"medium"}

    Source: manual_curated · Manually curated from the verified project README; no AI draft. · 8/17/2026

  • intro

    Verified

    {"en":"mirrord connects a local development process to a live Kubernetes environment. The code continues running on the developer machine, but after selecting a target pod the local process can use that pod’s incoming and outgoing traffic, file access, and environment variables so it interacts with real cluster services and data.\n\nIt is available as a VS Code extension, IntelliJ plugin, and CLI. When a pod is selected, mirrord starts a helper pod on the same node and connects the local process to the target environment. This allows developers to test local changes without first building and deploying a new image.\n\nThe project also documents workflows for AI coding agents including Claude Code, Cursor, Codex CLI, and Gemini CLI, allowing generated code to be verified against real cluster services. A local kubeconfig with suitable Kubernetes API access is required.","zh":"mirrord 用于把本地开发进程接到真实 Kubernetes 环境中。代码仍然运行在开发者电脑上,但可以选择一个目标 Pod,让本地进程复用该 Pod 的入站/出站流量、文件访问和环境变量,从而直接面对集群中的真实服务和数据。\n\n它提供 VS Code 扩展、IntelliJ 插件和 CLI 三种入口。调试时选择要模拟的 Pod 后,mirrord 会在相同节点启动辅助 Pod,并把本地进程与目标环境连接起来。这样可以在不先构建和部署镜像的情况下验证本地修改。\n\n项目还明确支持 Claude Code、Cursor、Codex CLI、Gemini CLI 等 AI 编程 Agent,让生成的代码可以在真实集群上下文中运行验证。使用前需要本机 kubeconfig 对目标 Kubernetes API 具有适当访问权限。"}

    Source: manual_curated · Manually curated from the verified project README; no AI draft. · 8/17/2026

  • Latest release

    Verified

    3.268.0

    Source: GitHub API · latest_release=3.268.0 · 10/3/2026

  • License

    Verified

    MIT

    Source: GitHub API · license.spdx_id=MIT · 10/3/2026

  • needs api key

    Verified

    No

    Source: manual_curated · Manually curated from the verified project README; no AI draft. · 8/17/2026

  • One-liner

    Verified

    {"en":"A developer tool that routes a local process through a Kubernetes pod so code can use live cluster traffic, files, and environment variables without deploying first.","zh":"让本地进程复用 Kubernetes Pod 的流量、文件和环境变量,在不部署新版本的情况下连接真实集群服务进行开发和调试。"}

    Source: manual_curated · Manually curated from the verified project README; no AI draft. · 8/17/2026

  • Platforms

    Verified

    windows, macos, linux

    Source: manual_curated · Manually curated from the verified project README; no AI draft. · 8/17/2026

  • Category hint

    Inferred from materials

    ai-apps

    Source: Project README · hint=ai-apps · 8/14/2026

  • product forms

    Verified

    cli, ide_plugin

    Source: manual_curated · Manually curated from the verified project README; no AI draft. · 8/17/2026

  • role tags

    Verified

    backend, devops

    Source: manual_curated · Manually curated from the verified project README; no AI draft. · 8/17/2026

  • supports docker

    Verified

    Yes

    Source: Repository file · dockerfile=true; compose=false · 10/3/2026

  • supports local

    Verified

    Yes

    Source: manual_curated · Manually curated from the verified project README; no AI draft. · 8/17/2026

Other verified projects matched by category, capabilities, and intended roles.