wingetCollections
  • Auto
  • Search
  • Awesome Collections
  • Awesome Programs
  • My Favorite Collections
  • My Collections
  • Account / Settings
  • Terms of Service
  • Privacy
  • About

© 2026 winget.ragerworks.com

Loading...
Install mirrord using Winget - wingetCollections
  1. Go back
  2. Packages
  3. mirrord
mirrord logo

mirrord MetalBear

api backend backend-development cli cloud cloud-native debug develop developer-tools development devops devtool ide kubernetes rust shift-left
Use this command to install mirrord:
winget install --id=MetalBear.mirrord -e

mirrord: Bridging Local Development with Kubernetes Environments

mirrord is a powerful tool designed to connect your local development environment with Kubernetes, enabling you to run local code in cloud conditions without deploying it. This innovative solution allows developers to test and debug applications as if they were running in a production environment, all from their local machine.

Key Features:

  • Multi-platform Support: Available as a Visual Studio Code extension, IntelliJ plugin, and CLI tool, mirrord integrates seamlessly into your workflow.
  • Traffic Mirroring: Enables bidirectional communication between your local process and Kubernetes pods, ensuring accurate testing of network interactions.
  • File Operations Handling: Automatically mirrors file reads and writes between your local machine and the Kubernetes environment.
  • Environment Variable Management: Synchronizes environment variables from the target pod to your local process for consistent behavior.
  • Customizable Capabilities: Offers flexibility by allowing developers to disable specific Linux capabilities, though this may limit functionality.

Audience & Benefits: Ideal for developers working with Kubernetes, especially those focused on backend development. By using mirrord, you can achieve faster iteration cycles and reduce the risk of deploying untested code to production environments. This tool provides a seamless way to integrate local development with cloud setups, ensuring your application behaves consistently across all stages.

mirrord is installed via winget, making it easy to set up and start leveraging its capabilities immediately.

README

mirrord logo

Community Slack Github CI License GitHub release (latest SemVer) X Follow

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.

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) 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.

You get the feedback of a deploy in seconds, without the deploy, and without disrupting the cluster for anyone else. mirrord ships as a VS Code extension, IntelliJ plugin, and CLI tool. Read more.

Adopted by: monday.com, SurveyMonkey, Cadence, CoLab, Daylight Security, Zooplus, and others.

Contents

  • Contents
    • Getting Started
    • VS Code Extension
      • Installation
      • How To Use
    • IntelliJ Plugin
Versions
3.223.0
3.222.0
3.221.1
3.221.0
3.220.0
3.219.0
3.218.0
3.217.1
3.217.0
3.216.0
show 1 more
Website
github.com
License
Last updated
6/26/2026
Download latest version
  • Installation
  • How To Use
  • CLI Tool
    • Installation
    • How To Use
  • How It Works
    • Additional capabilities
  • Using mirrord with AI coding agents
  • FAQ
  • Contributing
  • Help and Community
  • Code of Conduct
  • License

    • Getting Started

    • VS Code Extension
    • IntelliJ Plugin
    • CLI Tool

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

    VS Code Extension

    Installation

    Get the extension here.

    How To Use

    • Click "Enable mirrord" on the status bar
    • Start debugging your project
    • Choose pod to impersonate
    • The debugged process will be plugged into the selected pod by mirrord

    IntelliJ Plugin

    Installation

    Get the plugin here.

    How To Use

    • Click the mirrord icon in the Navigation Toolbar
    • Start debugging your project
    • Choose a namespace and pod to impersonate
    • The debugged process will be plugged into the selected pod by mirrord

    CLI Tool

    Installation

    You can use either

    brew install metalbear-co/mirrord/mirrord

    or

    curl -fsSL https://raw.githubusercontent.com/metalbear-co/mirrord/main/scripts/install.sh | bash

    or using Nix (not official, community maintained):

    # Using nix-env (legacy)
nix-env -iA nixpkgs.mirrord

# Using nix profile (recommended)
nix profile install nixpkgs#mirrord

    or on Windows using Chocolatey:

    choco install --pre mirrord

    How To Use

    mirrord exec  --target

    e.g.

    mirrord exec node app.js --target pod/my-pod

    How It Works

    When you select a pod to impersonate, mirrord launches a pod on the same node as the pod you selected. 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, routes outgoing traffic from your process through the pod, and does the same for file reads, file writes, and environment variables. You can read more about it here.

    Additional capabilities

    Container run inside the pod launched by mirrord requires additional Linux capabilities:

    • CAP_NET_ADMIN and CAP_NET_RAW - for modifying routing tables
    • CAP_SYS_PTRACE - for reading target pod environment
    • CAP_SYS_ADMIN - for joining target pod network namespace

    However, you can disable any subset of those in the configuration. This will possibly limit mirrord functionalities or even make it unusable in some setups.

    MIRRORD_AGENT_DISABLED_CAPABILITIES=CAP_NET_RAW,CAP_SYS_PTRACE mirrord exec node app.js --target pod/my-pod

    Using mirrord with AI coding agents

    mirrord works first-class with Claude Code, Cursor, Codex CLI, Gemini CLI, and other AI coding agents, letting them run and verify generated code against real cluster services without deploying.

    For setup guides and ready-made workflow skills, see metalbear-co/skills or the mirrord for AI Agents page.

    FAQ

    Our FAQ is available here. If you have a question that's not on there, feel free to ask in our Discussions or on Slack.

    Contributing

    Contributions are very welcome. Start by checking out our open issues, and by going through our contributing guide. We're available on Slack for any questions.

    Help and Community

    Join our Slack for questions, support and fun.

    We always appreciate hearing how mirrord has made a difference for our users.
    Check out our ADOPTERS.md to see how others are using mirrord —
    and open a pull request to add your organization if you’d like to share how mirrord has been useful to you.

    Code of Conduct

    We take our community seriously and we are dedicated to providing a safe and welcoming environment for everyone. Please take a few minutes to review our Code of Conduct.

    License

    MIT