# Mirrord Up

Helps users run multiple concurrent mirrord sessions from a single mirrord-up.yaml...

- Repository: https://github.com/metalbear-co/mirrord (5397 stars)
- Category: Testing
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add metalbear-co/mirrord --skill mirrord-up -g -a claude-code -y`
Codex: `npx skills add metalbear-co/mirrord --skill mirrord-up -g -a codex -y`
Cursor: `npx skills add metalbear-co/mirrord --skill mirrord-up -g -a cursor -y`
Gemini CLI: `npx skills add metalbear-co/mirrord --skill mirrord-up -g -a gemini-cli -y`

## Description

Helps users run multiple concurrent mirrord sessions from a single mirrord-up.yaml (compose-style multi-service local debugging). Use when the user mentions mirrord up, mirrord-up.yaml, mirrord up init, debugging several related microservices together, or managing multiple mirrord sessions' lifecycle in one command.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# mirrord up Skill

## Purpose

Help users create and run **multiple concurrent mirrord sessions** from one config file, think docker compose, but for mirrord, as documented in [Multiple concurrent sessions (mirrord up)](https://metalbear.com/mirrord/docs/using-mirrord/multiple-concurrent-sessions).

Useful when they need to debug **several related microservices** and manage those sessions' lifecycle together.

Each `services` entry is typically a **different** application with its own target, command, and configuration, `mirrord up` is for running several distinct applications together, not for targeting multiple pods of the *same* application. For that (label-based targeting), point users to the **mirrord-operator** or **mirrord-config** skill instead of trying to model it with `mirrord-up.yaml`.

## When to Use This Skill

Trigger on questions like:
- "How do I run multiple mirrord sessions at once?"
- "What is mirrord up / mirrord-up.yaml?"
- "Debug two microservices together with mirrord"
- "`mirrord up init`, how do I generate a config?"
- "How do session keys / HTTP filters work with mirrord up?"
- "What's the difference between split, replace, and mirror mode in mirrord up?"
- "How do I template / use env vars in mirrord-up.yaml?"

## Security Boundaries

> **IMPORTANT:** Follow these security rules for all operations in this skill.

The rest: https://github.com/metalbear-co/mirrord/blob/HEAD/mirrord/mcp/corpus/skills/mirrord-up/SKILL.md