# Mirrord Operator

Help users install and configure the mirrord Operator for team/enterprise environments.

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

## Install

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

## Description

Help users install and configure the mirrord Operator for team/enterprise environments. Use when users ask about operator setup, Helm installation, cloud API key or license configuration, air-gapped/offline licensing, enabling features (queue splitting, DB branching, preview environments, multi-cluster), internal registries, OpenShift/GKE Autopilot, RBAC, or multi-user mirrord deployments. Also use when an AI agent hits a Team or Enterprise feature on a cluster with no license and needs to offer the user a trial (agent-started trial; the trial is Enterprise tier).

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

# Mirrord Operator Skill

## Purpose

Help users install and operate the mirrord Operator, the persistent Kubernetes control plane that enables all mirrord **Team / Enterprise** features:
- **Install / upgrade** the operator via Helm
- **Authenticate** it with a cloud API key (default) or a license (key / offline PEM / license server)
- **Enable features** (queue splitting, DB branching, preview environments, multi-cluster)
- **Configure** registries, TLS, RBAC, and platform specifics (OpenShift, GKE Autopilot)
- **Troubleshoot** operator issues

## Why the Operator?

In open-source mirrord each session is standalone (the CLI creates a privileged agent pod directly). The Operator centralizes this:
- **Security**, users no longer need permission to create privileged pods; only the Operator does, and access is governed by Kubernetes RBAC.
- **Concurrency**, it coordinates many simultaneous sessions on one cluster.
- **Advanced features**, policies, profiles, queue splitting, DB branching, preview environments, multi-cluster.

## When to Use This Skill

Trigger on questions like:
- "How do I install the mirrord operator?"
- "Set up mirrord for my team" / "Configure mirrord licensing"
- "How do I enable Kafka splitting / DB branching / preview environments?"
- "Install the operator in an air-gapped cluster"
- "Use an internal registry for the operator images"
- "Operator not working"
- `Feature X requires using mirrord operator` or `Operator not found` on a cluster that has no mirrord for Teams license

## Security Boundaries

> Installing the operator **modifies a shared cluster**. Treat every operation as high-impact.

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