Open source, MIT licensed

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.

Read the docs
Hero headline
A“Ship faster with Acme”B“Cut your deploy time in half”C“Start free. No card needed.”D“Trusted by 4,000 teams”VisitorsSign-up
Version A
25%
—
Version B
25%
—
Version C
25%
—
Version D
25%
—
Day 1 of 30
learning…vs original
4.9 KB
gzip, with 7 analytics adapters
No flicker
variant chosen before paint
10%
always-on control group
MIT
self-host on Node or Workers
switch·man/ˈswɪtʃ·mən/noun
  1. 1A railway worker who throws the points at a junction, sending each train onto the right track.
  2. 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.

acme.dev · headline, 4 versions
desktop
Google Ads
A
Ship faster with Acme
19 sign-ups
B
Cut your deploy time in half
47 sign-ups
C
Start free. No card needed.
70 sign-ups
D
Trusted by 4,000 teams
41 sign-ups
desktop visitor from Google Ads sees C

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.

index.html
<!-- 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

Next.js
Site
Cloudflare
Site
Astro
Site
WordPress
Site
Hugo
Site
Eleventy
Site
Any HTML page
Site
Stripe
Payments
GA4
Analytics
PostHog
Analytics
Segment
Analytics
Amplitude
Analytics
Mixpanel
Analytics
Plausible
Analytics
Umami
Analytics
Google Ads
Ad traffic
Meta Ads
Ad traffic
TikTok Ads
Ad traffic
Microsoft Ads
Ad traffic
LinkedIn Ads
Ad traffic
Claude Code
Agent
Codex
Agent
Cursor
Agent
Any MCP client
Agent

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.

A/B test
Switchman
Answers
Is B better than A, with a clear result
Which version to show each visitor right now
Traffic
A fixed split, so the comparison stays clean
Shifts toward what's converting as results come in
Visitors
One winner for everyone, unless you segment after
Can find separate winners by device, source or country
Ends
When the test has enough data to call
Keeps running, with a 10% control group to measure the gain
Best for
Big decisions you need to be sure of: pricing, product, onboarding
Headlines, offers and calls to action, with lots of ideas and steady traffic

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.

Make free-trial the default on home/hero, test speed next #128
switchman-autopilot opened this on Monday · 1 file changed
free-trial beat the default by +41% over 1,204 conversions (p 0.98). Promoting it to the default and adding speed as the next version to test.
<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

Self-hosted
$0forever

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
HostedComing soon
$29per month

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.