breakpatch Install

AI on your Macno cloud*, no per-run fees

AI-powered UI testing that runs on your Mac.

Click through your web app. A vision AI model on your Mac names what you click. Replay any time and see exactly what broke. No code to write.

curl -fsSL https://breakpatch.dev/install | sh

BetaFree and open source · Apple Silicon · macOS 14 or later · 16 GB memory

* No cloud? Mostly sunny, with a light chance of cloud. Your screens and the AI stay on your Mac, and Breakpatch goes online only to download the AI model and the test browser once, for updates, and for anonymous usage counts you can turn off. Team workspaces (coming later) sync through the cloud, because that's how a team shares tests.

The Breakpatch recorder. The web app being tested is on the left and the recorded steps are on the right. The New project button on the page was just clicked, and the AI assistant names the step and asks “Click New project?” with Confirm and Try again.
The recorder: your web app on the left, the steps on the right, and the AI on your Mac naming what you clicked.

The AI

AI that reads the screen, not your code.

The AI looks at your app's screen the way a person does, and it runs on your Mac. It never needs to see your code, and nobody has to write test scripts.

For developers: Qwen3-VL 4B, an open-weights vision-language model, run on Apple Silicon through MLX. No selectors.

The steps of a test, named by the AI: Click New project, Click Project name, Click Done. Click Done is open: What to look for reads “Done button, bottom right of the Create project dialog”, with What should happen, Play this step, Play to here, Re-record and a menu for more.

Named steps

The AI names what you clicked.

Click something and the AI says what it is, so the test reads “Click New project”, not a pair of coordinates. Each step also keeps a plain What to look for, like “Done button, bottom right of the Create project dialog”. Edit it if it's wrong.

Editing steps

Private by design

On your Mac, and nowhere else.

The model runs on your Mac, so your screens never leave it. There's no cloud service, no API key to manage and no fee per run. Once it's downloaded, the AI works offline.

For developers: Qwen3-VL 4B, open weights, run on Apple Silicon through MLX.

About the AI assistant
Model
Qwen3-VL 4B, published openly
Runs on
Your Mac's own chip
Download
About 3 GB, once, during setup
Screens sent anywhere
None
API keys
None
Cost per run
Nothing

Self-healing tests Team, coming later

Tests that fix themselves when a button moves.

When a button has moved, the AI finds it again and the run carries on. The report marks the step Fixed automatically and shows the old and new positions. Nothing changes in the test until someone accepts it.

How fixing works

Why on-device AI

The AI runs where your app already is.

AI testing usually happens in someone else's cloud. Breakpatch runs the test browser and the model side by side on your Mac, which changes what testing costs and what it can reach.

  • Unlimited runs, no cloud billThe model runs on a Mac you already own. Run a suite every hour or on every build: there are no per-run, per-screenshot or per-token fees, in any edition.
  • Private and staging appsIf your Mac can open it, Breakpatch can test it: staging behind a VPN, an internal tool, or localhost. No tunnel, and no vendor to let through your firewall.
  • No test data sent to an AI vendorScreens, steps and saved secrets stay on your Mac. There's no model provider in the loop, so there's no one else's AI to add to your data review.
  • An open model, the same every runThe model is published openly and downloaded once. The same model runs every time until you change it, so no one swaps it under your tests.
Breakpatch and a typical cloud AI testing tool
QuestionTypical cloud AI toolBreakpatch
Where the model runsThe vendor's serversYour Mac
Your app's screensSent to the vendorStay on your Mac
Running more testsMetered by run or creditNo per-run fees
Apps behind a VPNTunnel or allow-listWork as they are
The modelUpdated by the vendorOpen, the same every run
API keysYesNone

Three steps. No code.

If you can use your app, you can test it.

  1. Record

    Open your app in Breakpatch and use it the way a person would: click, hover, drag, type, upload. Each action becomes a step, and the AI names what you clicked.

  2. Replay

    Press Run, or run a whole suite. Breakpatch does each step again and checks the screen before and after every one. In Team, coming later, the AI also finds buttons that moved.

  3. See what broke

    The first thing that's wrong stops the run. The report shows what was expected next to what was on screen, why, and what to try.

Screen checks and the report

Know what broke, and why.

After every step, Breakpatch checks the screen changed the way it did when you recorded it. There's nothing to draw or approve. When a run fails, the report puts what was expected next to what was on screen, and says why in plain words.

Visual checking, not AI. Screen checks compare how the screen looks with how it looked when you recorded, leaving out the parts of a page that change by themselves, like clocks and carousels. The same screen gets the same answer every time.

  • Reasons like “Couldn't find the Done button”, not error codes
  • Re-record this step, straight from the report
  • Copy → Markdown, for an issue: a ready-made bug report for GitHub, Jira, Linear or any tracker
  • Why did this fail? Team, coming later The AI says in plain words what changed, like “The Save button now reads Save changes”, and what to do
  • Create issue Team, coming later in GitHub, Linear or Jira in one click, with the steps, the screenshot and a link to the report
Reading the report
A failed run report. Step 6, Click Done, failed: “Couldn't find the Done button”. Expected and what was on screen are shown side by side, with What to try and a Re-record this step button.

Plain files

Your tests live in your repo.

In Community, every test is a readable JSON file in a folder you choose. Keep it next to your code and Git is your history: a change in the app shows up as a small, readable diff.

  • Shared steps: record Log in once and use it in every test
  • Saved secrets stay in your Keychain. Tests only store their names
  • Pull a change, switch back to Breakpatch, and it reads the folder again
How the tests folder works
The tests list for a web app: tests such as Create a project, Log in and out and Upload a file (PDF), each with its last run: Passed, Failed or Fixed automatically.
breakpatch.json
apps/web-app/
  app.json
  tests/create-a-project.json
  tests/log-in-and-out.json
  shared/log-in.json
suites/smoke.json

Local runner and CI Team, coming later

Runs on a schedule, or from your pipeline.

Pick one Mac to be the local runner. It runs suites on a schedule and whenever anyone presses Run on runner, with one queue for the whole team. Start suites from CI, a script or an automation tool, and get the result wherever you want it.

  • Schedules like Mon to Fri, 06:00
  • Run requests from Codemagic, GitHub Actions, Bitrise or Jenkins
  • Result messages to Slack and Microsoft Teams, with the failed step, why, and a link to the report, or to any web address
  • A failing test can stop a release before it ships, with breakpatch-ci
About the local runner
The suites list, each with its schedule and where results go: Smoke passed, started from Codemagic; Nightly is running on the local runner; Release check failed.
$ breakpatch-ci run --test tests/log-in.json
{ "name": "Log in", "result": "pass",
  "source": "ci", "durationMs": 21840, … }
$ echo $?
0

Your data

Your tests and screens stay yours.

The test browser and the AI model both run on your Mac, so your screens, steps and saved secrets stay there. In Community there's no Breakpatch server holding your tests.

AI on your MacAbout 3 GB, downloaded once during setup. Unloaded when it's idle.
Works offlineOnce set up, recording and running need no connection to us.
Your storageA folder you pick in Community. Team, coming later, adds a shared workspace, hosted by Breakpatch or in your company's own Google Firebase project (Create a workspace).
Counts you can turn offCommunity sends anonymous daily totals, with no IDs. Settings → Privacy shows them.
Exactly what's sent
Settings, AI assistant: ready, and it names each step you record. The Standard model, 3.1 GB on disk, on a Mac with 16 GB of memory. A note says it works well for almost every app and is the only one for now, with a button to remove it from this Mac.

Start free today. Team is coming later.

Community is free and open source, for one person on one Mac, and it's what you can install today. Solo adds the automation for one person. Team, which shares everything and runs it for you, is coming later. Its price isn't decided yet.

CommunityBeta

Available now
Freeopen source, Apache 2.0

One person, one Mac.

  • Record by clicking on the page
  • The AI names what you click, so steps read plainly
  • Run tests and suites by hand, with the full report
  • Tests as JSON files in a folder you pick
  • Saved secrets in your Mac's Keychain
  • Updates itself
Install Community

Solo

Paid
$16per month, billed yearly

$19 billed monthly · 1 person · 1 machine included

Just you, with the automation.

  • Everything in Community, plus:
  • Self-healing tests: the AI finds buttons that moved
  • Why did this fail?: the AI explains a failed step
  • Schedules on your Mac, with notifications and result messages
  • The CI command line
  • Tests stay in your folder or Git; your own workspace is optional
See pricing

Team

Coming later

Pricing to be decided

Your whole team in one shared workspace.

  • Everything in Community, plus:
  • A shared workspace, hosted by Breakpatch or in your company's own Google Firebase project (how that's set up)
  • Version history for every test
  • Self-healing tests: the AI finds buttons that moved
  • Why did this fail?, and Create issue in GitHub, Linear or Jira
  • A local runner Mac with schedules
  • Run requests, result messages to Slack and Teams, and the CI command line
Tell me when it's ready

Business, for 20 people or more, is coming later too: everything in Team, plus 5 machine licences, support within 4 business hours (Monday to Friday) and invoice billing. Tell me when it's ready.

Community, Solo and Team side by side
FeatureCommunitySoloTeam (coming later)
Record by clickingYesYesYes
The AI names what you clickYesYesYes
Screen checks and the reportYesYesYes
Shared steps and suitesYesYesYes
Where tests are keptA folderA folder or Git, or your own workspaceHosted by Breakpatch, or your company's own Firebase project
HistoryThrough GitThrough Git, or built in with a workspaceBuilt in
People11Your team
Copy a failure as MarkdownYesYesYes
Self-healing tests (Fixed automatically)NoYesYes
Why did this fail? (the AI explains)NoYesYes
Create issue in GitHub, Linear or JiraNoNoYes
Local runner and schedulesNoSchedules on your Mac; the local runner with a workspaceYes
CI command line and run requestsNoCI command line; run requests with a workspaceYes
Result messages to Slack and TeamsNoYesYes

Questions

Is it free?

Community is free and open source under Apache 2.0, with no time limit and no account. Solo, for one person, is $19 a month, or $16 a month billed yearly. Team and Business, the paid plans for working together, are coming later, and their prices aren't decided yet. See pricing.

Which AI model does it use?

A vision AI model that runs on your Mac and reads the screen. It's about 3 GB, downloaded once during setup, and unloaded when it's idle.

For developers: Qwen3-VL 4B, an open-weights vision-language model, run on Apple Silicon through MLX.

The AI names the steps you record. In Team, coming later, it also finds buttons that moved and says why a step failed. Screen checks don't use it: they're a visual comparison. See The AI assistant.

It's the only model for now. Bringing your own local one, through Ollama or LM Studio, isn't available yet. Cloud AI models aren't planned: your screens stay on your Mac.

Does the AI need the internet, or cost extra to run?

Only to download the model once, during setup. After that it runs offline, on your Mac. There are no API keys and no per-run fees, in any edition.

Does my data leave my Mac?

Your tests, screenshots and saved secrets don't. The test browser and the AI model both run on your Mac. In Community your tests are files in a folder you choose, and nothing of them reaches our servers. Team, coming later, keeps them in a shared workspace: in your company's own Google Firebase project (see Create a workspace), or hosted by Breakpatch.

Community sends anonymous daily totals of tests created and runs, with no names, addresses or IDs. You can turn that off in Settings → Privacy. The documentation lists exactly what's sent.

Which Macs does it run on?

A Mac with Apple Silicon (M1 or later), 16 GB of memory and macOS 14 or later. Intel Macs aren't supported. The AI model takes about 3 GB of disk space.

Linux comes next, then Windows.

How do I install and update it?

Paste one line into Terminal and Breakpatch is in your Applications folder a minute later. No password, no admin rights. After that it updates itself, so you're always on the latest version.

Want to see exactly what it does first? Read the script or the install guide.

What does Breakpatch send back to you?

Never your tests. Community sends only anonymous daily counts of tests created and runs, which you can turn off, and has no licence to check.

Team, when it comes, confirms its licence once a day and keeps working for 30 days without a connection. It sends the licence, who is using it (the person's work email, or the machine's name for a runner) and simple counts, such as how many tests ran and passed. Never test names, web addresses, steps or screenshots. The documentation lists every detail.

Can I use it in CI?

Not with Community. Team, coming later, adds two ways. Your pipeline can add a run request, and the local runner runs the suite and sends the result to Slack, Microsoft Teams or any web address. Or run breakpatch-ci run --test on the CI machine: it tells your pipeline whether the test passed, so a failing test stops the build. Both will work with Codemagic, GitHub Actions, Bitrise and Jenkins. See Run requests and From CI with breakpatch-ci.

Here to find what breaks.

Install Breakpatch and record your first test in about 10 minutes.

curl -fsSL https://breakpatch.dev/install | sh