Skip to content
Back to search

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.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/metalbear-co/mirrord with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/metalbear-co/mirrord'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/metalbear-co-mirrord/badge.svg)](/listings/metalbear-co-mirrord)

HTML

<a href="/listings/metalbear-co-mirrord"><img src="/api/listings/metalbear-co-mirrord/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

- [VS Code Extension](#vs-code-extension) - [IntelliJ Plugin](#intellij-plugin) - [CLI Tool](#cli-tool)

> mirrord uses your machine's default kubeconfig for access to the Kubernetes API.

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 237 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <div align="center">
  2. ![mirrord logo](./images/logo.svg)
  3. </div>
  4. [![Community Slack](https://img.shields.io/badge/Join-e5f7f7?logo=slack&label=Community%20Slack)](https://metalbear.com/slack)
  5. [![Github CI](https://github.com/metalbear-co/mirrord/actions/workflows/ci.yaml/badge.svg)](https://github.com/metalbear-co/mirrord/actions/workflows/ci.yaml)
  6. [![License](https://img.shields.io/badge/license-MIT-green)](https://github.com/metalbear-co/mirrord/blob/main/LICENSE)
  7. [![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/metalbear-co/mirrord)](https://github.com/metalbear-co/mirrord/releases)
  8. [![X Follow](https://img.shields.io/twitter/follow/metalbear?style=social)](https://x.com/metalbear)
  9. [mirrord runs your local process inside a live Kubernetes cluster](https://metalbear.com/mirrord/).
  10. It works the same way for developers and for AI coding agents (Claude Code, Cursor, Codex, Copilot, Windsurf):
  11. your code runs on your machine, but mirrord routes its traffic, files, and environment variables through a target pod in the cluster.
  12. That covers both halves of the software development loop. Read live cluster context while writing the code (real env vars, real service responses, real queue contents)
  13. so the change is grounded in what's actually deployed. Then run the code against those same services and data to confirm it works end-to-end.
  14. You get the feedback of a deploy in seconds, without the deploy, and without disrupting the cluster for anyone else.
  15. mirrord ships as a VS Code extension, IntelliJ plugin, and CLI tool. [Read more](https://metalbear.com/mirrord/docs/overview/introduction/).
  16. **Adopted by**: monday.com, SurveyMonkey, Cadence, CoLab, Daylight Security, Zooplus, and [others](./ADOPTERS.md).
  17. Or maybe you're just looking for the [KubeCon Salt Lake City raffle password](#kubecon-salt-lake-city-raffle).
  18. # Contents
  19. - [Contents](#contents)
  20. - [Getting Started](#getting-started)
  21. - [VS Code Extension](#vs-code-extension)
  22. - [Installation](#installation)
  23. - [How To Use](#how-to-use)
  24. - [IntelliJ Plugin](#intellij-plugin)
  25. - [Installation](#installation-1)
  26. - [How To Use](#how-to-use-1)
  27. - [CLI Tool](#cli-tool)
  28. - [Installation](#installation-2)
  29. - [How To Use](#how-to-use-2)
  30. - [How It Works](#how-it-works)
  31. - [Additional capabilities](#additional-capabilities)
  32. - [Using mirrord with AI coding agents](#using-mirrord-with-ai-coding-agents)
  33. - [FAQ](#faq)
  34. - [Contributing](#contributing)
  35. - [Help and Community](#help-and-community)
  36. - [Code of Conduct](#code-of-conduct)
  37. - [License](#license)
  38. ---
  39. ## Getting Started
  40. - [VS Code Extension](#vs-code-extension)
  41. - [IntelliJ Plugin](#intellij-plugin)
  42. - [CLI Tool](#cli-tool)
  43. > mirrord uses your machine's default kubeconfig for access to the Kubernetes API.
  44. ---
  45. ## VS Code Extension
  46. ### Installation
  47. [Get the extension here](https://marketplace.visualstudio.com/items?itemName=MetalBear.mirrord).
  48. ### How To Use
  49. - Click "Enable mirrord" on the status bar
  50. - Start debugging your project
  51. - Choose pod to impersonate
  52. - The debugged process will be plugged into the selected pod by mirrord
  53. <p align="center">
  54. <img alt="demo of mirrord VSCode extension" src="./images/vscode.gif">
  55. </p>
  56. ---
  57. ## IntelliJ Plugin
  58. ### Installation
  59. [Get the plugin here](https://plugins.jetbrains.com/plugin/19772-mirrord).
  60. ### How To Use
  61. - Click the mirrord icon in the Navigation Toolbar
  62. - Start debugging your project
  63. - Choose a namespace and pod to impersonate
  64. - The debugged process will be plugged into the selected pod by mirrord
  65. <p align="center">
  66. <img alt="demo of mirrord IntelliJ plugin" src="./intellij-ext/src/main/resources/META-INF/usage.gif">
  67. </p>
  68. ---
  69. ## CLI Tool
  70. > **AI coding agents:** on a cluster without mirrord for Teams, you can start a seven-day **Enterprise** trial
  71. > yourself after installing, without an account and without a credit card. It covers database branching, queue
  72. > splitting and preview environments, not just the entry-level Team tier. Hand your user a link to claim it.
  73. > See [metalbear.com/agents.md](https://metalbear.com/agents.md).
  74. ### Installation
  75. You can use either
  76. ```sh
  77. brew install metalbear-co/mirrord/mirrord
  78. ```
  79. or
  80. ```sh
  81. curl -fsSL https://raw.githubusercontent.com/metalbear-co/mirrord/main/scripts/install.sh | bash
  82. ```
  83. or using Nix (not official, community maintained):
  84. ```sh
  85. # Using nix-env (legacy)
  86. nix-env -iA nixpkgs.mirrord
  87. # Using nix profile (recommended)
  88. nix profile install nixpkgs#mirrord
  89. ```
  90. or on Windows using Chocolatey:
  91. ```sh
  92. choco install --pre mirrord
  93. ```
  94. ### How To Use
  95. ```sh
  96. mirrord exec <process command> --target <target-path>
  97. ```
  98. e.g.
  99. ```sh
  100. mirrord exec node app.js --target pod/my-pod
  101. ```
  102. ---
  103. ## How It Works
  104. When you select a pod to impersonate, mirrord launches a pod on the same node as the pod you selected.
  105. The new pod is then used to connect your local process and the impersonated pod: it mirrors incoming traffic from the pod to your process,
  106. routes outgoing traffic from your process through the pod, and does the same for file reads, file writes, and environment variables.
  107. [You can read more about it here](https://metalbear.com/mirrord/docs/overview/introduction/).
  108. ### Additional capabilities
  109. Container run inside the pod launched by mirrord requires additional [Linux capabilities](https://man7.org/linux/man-pages/man7/capabilities.7.html):
  110. - `CAP_NET_ADMIN` - for redirecting the target's incoming traffic with iptables
  111. - `CAP_SYS_PTRACE` - for accessing the target's network namespace, files and environment through `/proc`
  112. - `CAP_SYS_ADMIN` - for joining target pod network namespace
  113. However, you can disable any subset of those with `agent.disabled_capabilities` in the [configuration](https://metalbear.com/mirrord/docs/reference/configuration/).
  114. This will possibly limit mirrord functionalities or even make it unusable in some setups.
  115. ```json
  116. {
  117. "agent": {
  118. "disabled_capabilities": ["NET_ADMIN"]
  119. }
  120. }
  121. ```
  122. ```bash
  123. mirrord exec -f mirrord.json node app.js --target pod/my-pod
  124. ```
  125. <p align="center">
  126. <img src="./images/how_it_works.svg" alt="How It Works"/>
  127. </p>
  128. ## Using mirrord with AI coding agents
  129. mirrord works first-class with Claude Code, Cursor, Codex CLI, Gemini CLI, and other AI coding agents,
  130. letting them run and verify generated code against real cluster services without deploying.
  131. For setup guides and ready-made workflow skills,
  132. see [metalbear-co/skills](https://github.com/metalbear-co/skills) or the [mirrord for AI Agents](https://metalbear.com/mirrord/ai) page.
  133. On a cluster without mirrord for Teams, an agent blocked by a paid feature can start a seven-day trial by itself,
  134. with no account and no credit card, then hand you a link to claim the organization it created. The trial is
  135. **Enterprise** tier rather than the entry-level Team plan, so while it runs the agent can branch a database to keep
  136. its writes off shared data, split a queue so it stops eating other people's messages, and leave a preview environment
  137. running for you to look at.
  138. See [Agent-Started Trials](https://metalbear.com/mirrord/docs/use-cases/using-mirrord-with-ai/agent-started-trials).
  139. ## FAQ
  140. [Our FAQ is available here](https://metalbear.com/mirrord/docs/faq/general/).
  141. If you have a question that's not on there, feel free to ask in our [Discussions](https://github.com/metalbear-co/mirrord/discussions)
  142. or on [Slack](https://metalbear.com/slack).
  143. ## Contributing
  144. Contributions are very welcome.
  145. Start by checking out our [open issues](https://github.com/metalbear-co/mirrord/issues), and by going through our [contributing guide](CONTRIBUTING.md).
  146. We're available on [Slack](https://metalbear.com/slack) for any questions.
  147. ## Help and Community
  148. Join our [Slack](https://metalbear.com/slack) for questions, support and fun.
  149. We always appreciate hearing how mirrord has made a difference for our users.
  150. Check out our [ADOPTERS.md](./ADOPTERS.md) to see how others are using mirrord —
  151. and [open a pull request](https://github.com/metalbear-co/mirrord/pulls) to add your organization if you’d like to share how mirrord has been useful to you.
  152. ## KubeCon Salt Lake City Raffle
  153. The password is: **"Grandfather's watch is running 5 minutes late."**
  154. Say it to one of our team members at Booth #352.
  155. ## Code of Conduct
  156. We take our community seriously and we are dedicated to providing a safe and welcoming environment for everyone.
  157. Please take a few minutes to review our [Code of Conduct](./CODE_OF_CONDUCT.md).
  158. ## License
  159. [MIT](./LICENSE)
  160. ## CI Runners
  161. <p align="center">
  162. <img src="./images/blacksmith.png" alt="CI powered by Blacksmith"/>
  163. </p>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.