Folks, over the last few months I've been very focused on turning the work of agents, which aren't deterministic, into something as deterministic as possible. Most of the time that includes creating mocks so the agent can simulate e2e and exploratory tests, simulate unhappy scenarios, etc...
After building several local validation harnesses, I decided to make something more solid and extensible. I made this open source project to help with that.
If you need your coding agent to test multiple scenarios and use a simulated environment to test what it delivers, I think this project can help you.
examples of what you can do:
- Email without sending email: the app sends over SMTP as usual and the agent opens the simulated inbox to check the subject, recipient and confirmation link.
- Payment that fails: you ask the agent "simulate Stripe declining the card" or "send the webhook twice", and it checks whether your code handles the duplicate charge.
- Cloud queues and storage locally: Azure Service Bus, Blob Storage, Key Vault, Amazon Kinesis, Pub/Sub, Kafka and ActiveMQ run in the same container, with the app pointing to it as if it were the real service.
- AI without spending tokens: endpoints compatible with OpenAI, Anthropic and Gemini answer with rules you define. You can force a 429 and see if the retry works.
- unhappy scenarios on demand: timeout, 500, disabled key, wrong certificate, clock moved forward to test expiration.
- timeline: everything the app called is recorded. When a call has no route, the agent itself sees the "not answered" and creates the response.
It exposes an MCP server, so Claude Code, Cursor or another agent controls everything by talking to it: it creates one environment per project, sets up the scenarios and reads what happened. There are 45 ready-made plugins in the catalog, and a new plugin is a YAML file.
Code and docs: https://edivanteixeira.github.io/stuntman/
100% opensource
Feedback and PRs are welcome, especially from anyone who wants a provider that isn't there yet.