emulate

What problem does it solve?

Provide production-fidelity, stateful local replacements for external cloud APIs so developers and CI systems can run integration tests, OAuth flows, and autonomous agent sandboxes without network access or reliance on third-party services.

Core Features & Use Cases

• Stateful service emulation: Full Vercel, GitHub, and Google API behavior with persistent stores, token-based auth, and seeded data for realistic testing.
• Dual interface: Convenience CLI for zero-config local runs and a programmatic createEmulator API for test frameworks and CI integration.
• Reproducible seeds and controls: Support for YAML/JSON seed files, reset and close controls, configurable ports, and default tokens to simplify no-network CI and agent sandbox workflows.
• Use Case: Run end-to-end integration tests that exercise OAuth callbacks, repo operations, and deployment flows in a reproducible local environment.

Quick Start

Start the emulator by running npx emulate to launch Vercel, GitHub, and Google emulators with sensible defaults and optional seed configuration.