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.
Borrowing it
Nothing to install: this file belongs to metalbear-co/mirrord. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/metalbear-co/mirrord/main/AGENTS.mdgit clone --depth 1 https://github.com/metalbear-co/mirrordWrote 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.
[](https://agentmods.dev/instructions/metalbear-co/mirrord/agents-md)<a href="https://agentmods.dev/instructions/metalbear-co/mirrord/agents-md"><img src="https://agentmods.dev/badge/instructions/metalbear-co/mirrord/agents-md/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.
<a href="https://agentmods.dev/instructions/metalbear-co/mirrord/agents-md"><img src="https://agentmods.dev/badge/instructions/metalbear-co/mirrord/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>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.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.02915 | $0.02915 |
| Opus 5.5 | $0.01166 | $0.01166 |
| Sonnet 5.5 | $0.00583 | $0.00583 |
| Haiku 4.5 | $0.00292 | $0.00292 |
Grade A, and why
mirrord AGENTS.md scanned grade A with 0 findings 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.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 205 lines — stays where its author put it; the contents beside it link to each section on GitHub.
mirrord
Overview
mirrord is a tool that lets developers run local processes in the context of their Kubernetes cloud environment.
CONTRIBUTING.md has the procedures: preparing a cluster for the end-to-end tests, debugging with mirrord-console,
building the agent on macOS, adding a hook or a target type, and releasing.
Core Crates
mirrord-layer: gets loaded into the user's process viaLD_PRELOAD/DYLD_INSERT_LIBRARIES. Intercepts libc calls (files, networking, DNS, env, ...) and turns them into protocol messages sent to the intproxy.mirrord-intproxy: a local process spawned by the CLI that bridges N layers and 1 agent. Matches requests to responses, handles reconnects, and routes messages to the right feature proxy.mirrord-agent: the in-cluster component of mirrord. Runs in the target pods' context and network namespace. Does the actual I/O work requested by the layers.mirrord-protocol: defines the shared messages (ClientMessage,DaemonMessage) sent between layer/intproxy/agent.mirrord-config: config types and validation. Used by the CLI and layer to decide what features are enabled and what target to use.mirrord: the CLI that resolves configuration, creates or connects to the agent, starts the intproxy, and launches the user's local process with the mirrord layer loaded.mirrord-mcp: the MCP server behindmirrord mcp, which exposes mirrord to AI agents over stdio.
Command Reference
Compiling
# check the entire workspace at once
# always use when a change spans multiple crates instead of checking each crate individually
# CI appends `-- -Wclippy::indexing_slicing` to every clippy run, so add it to any clippy command here
CARGO_BUILD_WARNINGS=deny cargo clippy --all-targets --all-features --keep-going -- -Wclippy::indexing_slicing
# check a specific crate
# the agent is linux only
CARGO_BUILD_WARNINGS=deny cargo clippy -p mirrord-agent --target x86_64-unknown-linux-gnu --keep-going -- -Wclippy::indexing_slicing
# rustdoc of private items, as `check-rust-docs` builds it
RUSTDOCFLAGS=-Dwarnings cargo xtask test-doc
# layer and cli bundled with the new layer
# use only when a fresh mirrord + layer binary is needed for testing
cargo xtask build-cli
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.
- yesterday Changed · +2 lines · +52 tokens per session 88dddae75a0f
- 3d ago Changed · +73 lines · +1,186 tokens per session 01f5bb54d431
- 9d ago Changed · +11 lines · +191 tokens per session b2746ef8da92
- 20d ago Changed · +13 lines · +244 tokens per session 207b500d7d95
- 26d ago Changed · +2 lines · +17 tokens per session 371a9afed87b
- 29d ago Changed · +5 lines · +180 tokens per session 29a76de9fda9
- 1mo ago Changed · +3 lines · +84 tokens per session d8dd7bd52c83
- 1mo ago Changed · +5 lines · +75 tokens per session 793b85a449d7
- 1mo ago Changed · +6 tokens per session 50ba1574cc44
- 2mo ago First seen · 91 lines · 880 tokens per session scan A 0825d9e417db
mirrord AGENTS.md is an instructions file published in the GitHub repository metalbear-co/mirrord (5,401 stars, last pushed yesterday), licensed MIT. It adds 2,915 tokens to every session, about $0.0117 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
mirrord AGENTS.md compared with instructions from other repositories
| Mod | Type | Stars | Last push | Licence | Scan | Tokens | Works with |
|---|---|---|---|---|---|---|---|
| mirrord AGENTS.mdmetalbear-co/mirrord | Instructions file | 5.4k | yesterday | MIT | A | 2,915 | Codex, OpenCode |
| vscode buildNext.instructions.mdmicrosoft/vscode | Instructions file | 195k | yesterday | MIT | A | 9,719 | GitHub Copilot |
| next.js AGENTS.mdvercel/next.js | Instructions file | 143k | today | MIT | A | 7,461 | Codex, OpenCode |
| langchain AGENTS.mdlangchain-ai/langchain | Instructions file | 149k | yesterday | MIT | A | 4,680 | Codex, OpenCode |
| vscode oss-third-party-notices.instructions.mdmicrosoft/vscode | Instructions file | 195k | yesterday | MIT | A | 5,516 | GitHub Copilot |
| vscode copilot-instructions.mdmicrosoft/vscode | Instructions file | 195k | yesterday | MIT | A | 3,093 | GitHub Copilot |
| deepseek-harness AGENTS.mddeepseek-ai/deepseek-harness | Instructions file | 274k | 2d ago | MIT | A | 4,313 | Codex, OpenCode |