Show every visitor the version that converts best.
Switchman is open-source conversion optimisation. Write a few versions of a headline, an offer or a page, and it sends each visitor to the one most likely to convert for them. A control group measures the gain.
- switch·man/ˈswɪtʃ·mən/noun
- 1A railway worker who throws the points at a junction, sending each train onto the right track.
- 2Open-source software that does the same for a website, sending each visitor to the version of a page most likely to convert them.
What visitors see
Every visitor sees exactly one version of the headline: the one that has worked best for people like them, by device and by where they came from. Here it is one visitor at a time.
How it works
Wrap the part of the page you want to test, like a headline, in a slot, and put each version inside it. The first version is the default and the rest stay hidden until Switchman shows them. If the script doesn't load, visitors see the default.
<!-- first in <head> --> <script src="https://switch.example.com/v1/s/acme.js"></script> <section data-sm-slot="hero"> <div data-sm-variant="default"> <h1>Ship faster</h1> </div> <div data-sm-variant="free-trial" hidden> <h1>Start free. No card.</h1> </div> </section>
Works with your stack
Switchman or an A/B test?
A/B testing is still the most rigorous way to find out whether a change works. Switchman is an alternative for when you'd rather put more visitors on what's converting while it learns, and keep adapting after.
Built for coding agents
An agent writes the variants and opens a pull request, and you review it. The config lives in your repo and everything else is a CLI command.
<section data-sm-slot="hero">- <div data-sm-variant="default"><h1>Ship faster</h1></div>- <div data-sm-variant="free-trial" hidden>+ <div data-sm-variant="default"><h1>Start free. No card.</h1></div>+ <div data-sm-variant="speed" hidden>+ <h1>Live in five minutes.</h1>+ </div></section>
- SKILL.md
- Instructions that teach Claude Code, Codex or Cursor how to run Switchman.
- switchman brief
- Results so far, past tests and the live markup, as context for writing the next variant.
- switchman plan
- What to do next, ranked: promote, retire, add a variant, split by segment, or update the markup.
- switchman mcp
- An MCP server so agents can read status, results and history. Making changes needs --allow-act.
- autopilot.yml
- A weekly GitHub Action that runs the plan and opens a pull request.
Pricing
Everything, MIT licensed. Run the server on Node and SQLite, or on Cloudflare Workers and D1.
- The server that stores results, plus a dashboard
- CLI, MCP server and agent skill
- Next.js and Cloudflare integrations
- PostHog and Stripe integrations
We host the server for you. Your config stays in your repo.
- Hosted server with backups
- The same open-source runtime
- Unlimited tests and variants
- Move to self-hosted at any time
FAQ
Get started
This writes switchman.config.json and prints the snippet to paste into your page.