mirrord-quickstart

mirrord-quickstart is a skill for Claude Code, Codex from metalbear-co/mirrord. It costs 49 tokens per session (1,259 once invoked), scanned A, original, MIT.

A beginner's guide to installing mirrord and making a first connection to an application in a Kubernetes cluster. Kubernetes is a system for running and managing containers across machines.

In plain words
What is it for?
Use it to choose a command-line, VS Code, or IntelliJ workflow, install mirrord, check kubectl access, connect to a first target, and verify that the session works.
Why use it?
It removes the setup uncertainty for someone who has not used mirrord before, including checking system requirements and access to the cluster.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit Use it to choose a command-line, VS Code, or IntelliJ workflow, install mirrord, check kubectl access, connect to a first target, and verify that the session works.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/metalbear-co/mirrord/mirrord-quickstart
About the project

mirrord lets a program running on a developer’s machine behave as though it were running inside a selected pod in a Kubernetes cluster, by routing the pod’s environment, files, network, and traffic to the local process. Developers and AI coding agents use it to build and test against live cluster services without deploying or disrupting other users; the catalogue entries provide instructions for using it.

metalbear-co/mirrord · 5,361 stars · on GitHub · metalbear.com

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add metalbear-co/mirrord --skill mirrord-quickstart
Clone the repo
git clone --depth 1 https://github.com/metalbear-co/mirrord

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for mirrord-quickstart

README.md
[![agentmods](https://agentmods.dev/badge/skills/metalbear-co/mirrord/mirrord-quickstart/github.svg)](https://agentmods.dev/skills/metalbear-co/mirrord/mirrord-quickstart)
Your own site
<a href="https://agentmods.dev/skills/metalbear-co/mirrord/mirrord-quickstart"><img src="https://agentmods.dev/badge/skills/metalbear-co/mirrord/mirrord-quickstart/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for mirrord-quickstart

Your own site · 80×15
<a href="https://agentmods.dev/skills/metalbear-co/mirrord/mirrord-quickstart"><img src="https://agentmods.dev/badge/skills/metalbear-co/mirrord/mirrord-quickstart.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 49 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,259 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00049 $0.01259
Opus 5.5 $0.00020 $0.00504
Sonnet 5.5 $0.00010 $0.00252
Haiku 4.5 $0.00005 $0.00126

Measured yesterday against content hash 02f12e6af83d, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

mirrord-quickstart scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

- **Browser extension** — routes requests made from Chrome to the local process, for testing an HTTP-filtered session from a browser instead of `curl`. See [Debugging from Browser](https://metalbear.com/mirrord/docs/usin
Origin

Copies of this mod

1 near-identical copy found in the catalogue:

mirrord/mcp/corpus/skills/mirrord-quickstart/SKILL.md · 142 lines

How it starts

The opening of the file, as written. The whole thing — 142 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Mirrord Quickstart Skill

Purpose

Help new users get mirrord running quickly:

  • Check system requirements
  • Install mirrord (CLI, VS Code, or IntelliJ)
  • Connect to their first Kubernetes target
  • Verify the connection works

Critical First Steps

Step 1: Detect user's environment Ask or detect:

  • Operating system (macOS, Linux, Windows)
  • Preferred workflow (CLI, VS Code, IntelliJ)
  • Do they have kubectl configured?

Step 2: Verify requirements

# Check kubectl access
kubectl cluster-info
kubectl get pods -A | head -5

If kubectl fails, help them configure it first.

Installation Paths

CLI (recommended for getting started)

Do not run remote install scripts that pipe a network download into a shell interpreter. Use only methods your organization approves.

Official guide: Follow mirrord installation documentation for supported options (package managers, pinned release binaries with checksum verification, etc.).

Summary for the agent:

  • macOS / Linux: Point the user to the official docs for Homebrew, apt, or pinned binary install steps — do not invent or paste one-liners that fetch and execute remote scripts.
  • Windows: Point the user to the official docs for supported installers.

Security: Prefer package managers or manually verified binaries from official release artifacts. Never execute installation by piping downloaded content into a shell.

Verify installation:

mirrord --version

VS Code Extension

  1. Open VS Code Extensions (Cmd/Ctrl+Shift+X)
  2. Search "mirrord"
  3. Install "mirrord" by MetalBear
  4. Look for mirrord icon in status bar

IntelliJ Plugin

  1. Open Settings → Plugins → Marketplace
  2. Search "mirrord"
  3. Install and restart IDE
  4. Find mirrord in navigation toolbar

First Session

CLI approach

# List available targets
mirrord ls

# Run a local process with mirrord
mirrord exec --target pod/<pod-name> -- <your-command>

# Example: Node.js app
mirrord exec --target pod/api-server-7c8d9 -- node app.js

# Example: Python app
mirrord exec --target pod/backend-abc123 -- python main.py

Read the full file on GitHub · 142 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 142 lines · 49 tokens per session scan A 02f12e6af83d

Subscribe to this mod's changes

mirrord-quickstart is a skill published in the GitHub repository metalbear-co/mirrord (5,361 stars, last pushed today), licensed MIT. It adds 49 tokens to every session and 1,259 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-10-09.

Related

Other skills, from other repositories

network-rca

Kubernetes network root cause analysis skill powered by Kubeshark MCP. Use this skill whenever the user wants to investigate past incidents, perform retrospective traffic analysis, take or manage traffic snapshots, extract PCAPs, dissect L7 API calls from historical captures, compare traffic patterns over time, detect…

kubeshark/kubeshark · 163 tokens

modal-sandboxes

Connect Modal and create reusable cloud machines with the bundled standard image, on-demand daemon installation, and snapshot lifecycle.

get-bb/bb · 27 tokens

animation

Author animated technical explainer diagrams as .anim.json files for Nimbalyst's Animation editor. Use when the user wants to animate a diagram, show how a system/protocol/algorithm behaves over time, build a motion explainer, or turn a static architecture diagram into something that plays.

nimbalyst/nimbalyst · 60 tokens

k8s-service-path

Trace the Kubernetes service path — Service to selector to pods to EndpointSlices to readiness, plus Ingress routing. Use when a service is getting no traffic, an ingress is not routing, or someone asks why a workload is unreachable inside a cluster.

automateyournetwork/netclaw · 55 tokens

k8s-agent-sandbox-mcp

An MCP server skill for managing Kubernetes sandboxes. Enables creating, executing commands, managing files, and terminating instances via the official kubernetes-sigs/agent-sandbox MCP server.

kubernetes-sigs/agent-sandbox · 46 tokens

configure-sqrl

Use when configuring a DataSQRL project's -package.json files. Use for engine selection (Flink, Postgres, Kafka, Iceberg and its query engines DuckDB, Snowflake, Spark SQL, Redshift, Trino), API protocols, compiler options, runtime settings, or deployment/infrastructure settings.

DataSQRL/sqrl · 69 tokens