Get started

From zero to a running local API simulator in under a minute.

TAKE 1

Install stunt

# macOS (Homebrew)
brew install stuntapi/tap/stunt

# or Go
go install stuntapi.com/stunt/cmd/stunt@latest

# verify
stunt --version

TAKE 2

Try the demo (no config)

$ stunt demo

Boots the bundled stripe-style simulator, prints copy-pasteable curl commands, and shows stateful behavior + webhooks firing.

TAKE 3

Describe your own services

$ stunt init          # writes a sample stunt.yaml
$ stunt plan          # validate + preview
$ stunt up            # serve on 127.0.0.1:8000

Add an adapter — every one of the 91 reference adapters ships in the binary:

services:
  stripe:
    adapter: embedded:stripe-style   # bundled, no clone
  myapi:
    adapter: ./adapters/myapi-style  # or a local dir

TAKE 4

Point your code at it

STRIPE_API_BASE_URL=http://127.0.0.1:8000 \
  ./run-your-tests

State persists across requests; stunt clean resets it.

Full reference

The complete manifest schema, CLI command reference, and the Starlark handler API live in AGENTS.md in the repo — and in-binary via stunt llm (feed it to a coding agent as cold-start context).

AGENTS.md →$ stunt llm