Skip to content

Mirra

Drop-in mirrors for the application infrastructure your code talks to — payments, email, SMS, auth, commerce. Real webhook signatures, real state machines, real idempotency enforcement. Zero real-world side effects.

Modern SaaS apps integrate with 10–30 third-party services. Testing those integrations is broken — mocks lie, real APIs are expensive and unsafe at scale, and shared staging collides past five engineers. AI coding agents make it worse; they ship integration code grounded in training-data guesses, not today's vendor behavior.

Mirra provides the ground-truth substrate: stateful mirrors that behave like the real vendor APIs. Point your code at Mirra URLs, run tests, inspect traffic, ship with confidence.

Install

# per-project (recommended for CI)
pnpm add -D @mirralabs/cli

# one-off
pnpm dlx @mirralabs/cli up

# global
npm i -g @mirralabs/cli
curl -fsSL https://mirra.run/install.sh | sh
mirra login                      # browser device-code flow
mirra up --project prj_xxx       # spin up a mirror session
mirra logs --follow              # stream every request
mirra down                       # tear it down

Node ≥ 20.17 required.

Catalog

Status Mirrors
Launch Resend
Month 2 Twilio, Stripe
Year 1 SendGrid · Mailgun · Postmark · Plaid · Auth0 · Clerk · Shopify · Mailchimp · OpenAI · Anthropic · Postgres · Redis · S3

Each mirror ships with automated fidelity tests against captured real-API fixtures and a weekly drift-detection job. Public SLA: critical drift detected within 7 days, fixed within 14.

How it works

Two planes, one bus.

  • Control plane — NestJS + Fastify API + Next.js dashboard. Provisions sessions, captures traffic, evaluates runs.
  • Data plane — each mirror is a Fastify process with per-session SQLite state. Vendor-correct HMAC signing. Auto-wired admin API at /_mirra/*.
  • Event bus — Redis Streams. Five idempotent consumers upsert to Postgres and fan out to the dashboard over Socket.io.

Mirrors never touch Postgres. The API never touches mirror SQLite. The bus is the only handshake.

Open source

  • Apache 2.0@mirralabs/mirror-engine, @mirralabs/events, @mirralabs/cli, @mirralabs/vitest, @mirralabs/jest, @mirralabs/skills
  • BSL 1.1 (4-year Apache conversion) — individual mirror implementations
  • Closed source — hosted control plane, dashboard

Sentry / MariaDB pattern: community contribute and self-host freely; commercial competitors wait four years.

Integrations

  • CLI — this org's @mirralabs/cli npm package
  • Vitest / Jest — drop-in config wrapper; existing test suites adopt Mirra with one line
  • MCP — standalone Model Context Protocol endpoint for Claude Code, Cursor, Windsurf, Copilot agent mode
  • GitHub App — integration drift checks on PRs

Repos

Repo What
mirra Main monorepo — API, dashboard, orchestrator, engine, first mirrors
more coming Mirror implementations will migrate to dedicated repos as the catalog grows

Links


Pre-launch. MVP shipping April 2026. Two senior engineers, 27 combined years of building and shipping production infrastructure.

Mirra is not affiliated with, endorsed by, or sponsored by Stripe, Resend, Twilio, or any vendor whose APIs are mirrored. All trademarks are property of their respective owners.

Popular repositories Loading

  1. docs docs Public

    MDX

  2. .github .github Public

    Mirra org profile

Repositories

Showing 2 of 2 repositories

Top languages

Loading…

Most used topics

Loading…