The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Smolanalytics listing page.
End-to-end tests written as one English sentence. An agent runs them in a real browser, and a passing run replays with no model call.
A test is one sentence in a markdown file. An agent opens a real browser, reads the page through its accessibility tree, works out how to do what the sentence says, and returns a verdict. There is no test code, so there is no selector to update when a button moves.
A run that passes is recorded, and every run after it replays that recording with no model call at all. The agent comes back only when the recording stops fitting your app.
Five verdicts, never blurred: passed, failed, stale, errored, flaky. Only failed is a claim about your app. A recording that stopped fitting is stale, never a bug report, and a runner that could not finish is errored, never counted against you.
test --suite tests/ --url <preview> --comment runs a folder of sentences and leaves one comment on
the pull request, edited in place on every push: what broke, the file most likely responsible and
the evidence for that guess. Exit codes are 0 (clean), 1 (your app failed a test) and 2 (the runner
could not finish). The workflow file is in the docs.
Three tools: run_tests, can_i_ship and list_tests. Listed on the official MCP Registry as
io.github.Arjun0606/smolanalytics.
smolanalytics.com/proof is a GitHub Action that runs this product's own suite against two live sites every night and publishes every verdict, including the red ones. Nothing on that page is written by hand.
The CLI runs on your machine or your CI runner, on your own ANTHROPIC_API_KEY. A first run of a
test costs roughly what one agent conversation costs; a replay costs nothing. The hosted side at
smolanalytics.com is $19/month with 100 tested pull requests included,
after a 14-day trial with no card. This is commercial software, not open source.
Full CLI reference: cli/README.md. Questions: smolanalytics.com/contact.