Beta Early access — actively developed, stable enough to try today. Share feedback →
✨ AI-powered UI testing — no selectors, no scripts
npm version npm downloads GitHub stars license

Write tests in words.
The AI runs them in the browser.

Describe what to test in words. TestWithWords drives a real browser with AI — clicking, typing, verifying — and gives you screenshot evidence.

Get Started → See Demo ↓
$ npm i -g testwithwords
⚡ Real browser automation 📸 Screenshot evidence 🧪 Runnable package examples
examples/basic.test.tww 
# Ships in the package

url https://www.wikipedia.org

test "Wikipedia homepage loads"
  Verify the page shows "Wikipedia"
Terminal + report 
$ tww run examples/basic.test.tww

🧪 TestWithWords v0.1.5
Chromium (standalone) · github/gpt-4.1-mini

PASS  examples/basic.test.tww
  ✓ Wikipedia homepage loads (4.2s)

Screenshots: 3 captured
Report:      results/run-1/report.html
Summary:     1 passed, 0 failed
✨ First impression: words in, real browser actions out, screenshots included.

See It In Action

Write a .tww file on the left. Get test results on the right.

cart.test.tww 
# cart.test.tww

describe "Shopping Cart"

  test "can add item to cart"
    Navigate to the shop homepage
    Search for "mechanical keyboard"
    Click on the first product
    Click "Add to Cart"
    Verify the cart shows 1 item
↓
Terminal 
$ tww run cart.test.tww

          🧪 TestWithWords v0.1.5
          Chromium (standalone) · github/gpt-4.1-mini

 PASS  cart.test.tww
  Shopping Cart
    ✓ can add item to cart (8.4s)

 Tests:  1 passed, 0 failed
 Time:   8.4s
 📄 Report: results/report.html

Why TestWithWords?

Stop fighting with selectors and scripts. Start testing in words.

Natural Language Tests

Write tests the way you'd explain them to a teammate. No code, no selectors, no XPath. If you can describe it, you can test it.

AI-Powered Automation

An AI agent reads the page, decides what to click, type, or verify — and adapts when the UI changes. No brittle scripts that break on every redesign.

Visual Evidence

Every test step produces a screenshot. See exactly what happened, when it happened, and share results in a beautiful HTML report.

Free to Start

Works out of the box with GitHub Models — free for open source contributors. No API keys to buy.

How It Works

Three steps. Under two minutes. You're testing.

1

Write

Describe your test in a .tww file using words. Structure with describe and test blocks — just like Jest.

2

Run

Execute with tww run. The AI agent launches a browser, reads the page, and performs every step you described.

3

Results

Get a Jest-style pass/fail summary in the terminal, plus an HTML report with screenshots of every step.

Quick Start

Three commands and you're running AI-powered tests.

Terminal 
# Install globally
$ npm i -g testwithwords

# Authenticate with GitHub Models (free!)
$ tww auth

# Run your first test
$ tww run "Go to www.testwithwords.com and verify the heading says Write tests in words"

Examples You Can Run Right Away

Try it now — this exact file ships in the npm package, so your first run can start with something real.

basic.test.tww 
# basic.test.tww

url https://www.wikipedia.org

test "Wikipedia homepage loads"
  Verify the page shows "Wikipedia"
✅ Try it now

Start with a real .tww file, not a fake snippet.

Install the package, then run tww run examples/basic.test.tww to watch TestWithWords open a real browser and verify a real page.

This file ships with the package in examples/basic.test.tww.

Run the quick start Open GitHub repo

Documentation

Everything you need to get started and go deep.

Getting Started

Full walkthrough from install to your first passing test.

CLI Reference

Every command and flag, with examples for each.

.tww Format

How to write test files — describe, test, hooks, reusable flows.

Configuration

.twwrc.json settings reference for advanced setups.

Troubleshooting

Real error messages and real fixes.

Built by Instafluff

TestWithWords is open source and free to use. Star the repo, share it, or just say hi!

⭐ Star on GitHub 💖 Sponsor 📚 Read the docs 📦 npm