emulate

Emulate Vercel, GitHub, and Google APIs with stateful local servers.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/andreasasprou/polaris --skill emulate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: emulate
Source: https://github.com/andreasasprou/polaris/tree/main/.agents/skills/emulate
Command: npx skills add https://github.com/andreasasprou/polaris --skill emulate

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about emulate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I test OAuth flows and GitHub APIs locally without network access?

Run local emulators to provide stateful, production-fidelity HTTP endpoints for Vercel, GitHub, and Google APIs, enabling no-network testing of OAuth flows and repo operations with configurable ports and token-based authentication.

Can I use Vercel and Google API emulators in a CI pipeline for integration tests?

Yes, you can integrate Vercel and Google API emulators into CI pipelines using a programmatic createEmulator API, which supports seeded JSON or YAML configurations, reset controls, and default tokens to ensure reproducible no-network test execution.

What is local cloud API emulation and when do I need it for agent sandboxes?

Local cloud API emulation replaces external services with stateful local servers, needed when autonomous agent sandboxes require safe, reproducible environments to exercise deployment flows and OAuth callbacks without hitting real third-party rate limits.

How do I seed a local GitHub emulator with test repository data?

Provide YAML or JSON seed configuration files when starting the emulator to populate persistent stores with test repository data, establishing reproducible local states that can be reset via CLI or programmatic API controls.

Does local API emulation support stateful behavior for deployment and repo operations?

Yes, local API emulation supports stateful behavior by maintaining persistent stores for deployment and repo operations, allowing integration tests to execute multi-step OAuth callbacks and Vercel deployment flows with realistic data interactions.