Skip to main content

Waterwheel

AI browser test agent — write tests in plain English, skip the QA bottleneck

  • Plain-English Markdown tests
  • Pennies per test case
  • Any major AI provider
  • Runs anywhere via Docker
  • Nested agent loops
  • Fully automated web development

Write a test the way you'd describe it

No selectors, no scripting, no flaky page objects. Describe the outcome in plain Markdown and let the agent drive the browser.

tasks/test-wikipedia-english.md
# Test Wikipedia English Language Banner

## Success Condition
- [] Wikipedia is reachable.
- [] The English language entry point is clickable.
- [] The banner displays "Welcome to Wikipedia".

## Steps
1. Go to https://www.wikipedia.org.
2. Click the English language link.
3. Confirm the "Welcome to Wikipedia" banner is shown.
  1. 1

    Describe it

    Drop a Markdown file into your tasks folder that states the steps and success conditions in plain language.

  2. 2

    Run it

    One run-qa command and the agent opens a real browser, follows your steps, and reasons about the page.

  3. 3

    Read the result

    Get a clear pass/fail report with a full diagnostic trail when something breaks — no screenshots to decode.

Built for real-world QA

Everything you need to automate front-end testing without the usual maintenance tax.

Plain Text Testing

All test tasks are plain Markdown files — no scripting required. Write automation in plain language. Manage Test Tasks

TT

Minimal Token Usage

Handles complex scenarios and large chained test suites without hitting token limits. Efficient token handling reduces real-world test costs to pennies per test case. AI Benchmark

Fully Harnessed

The agent is isolated through multiple layers of permission controls, from the container down to individual tools. Agent Permissions

AI Agnostic

Supports all major AI providers: Claude, OpenAI, Google Gemini, DeepSeek, and Gemma 4. Provider Guide

Easy to Use

Delivered as a Docker image. Configure once and integrate seamlessly into your development, CI/CD, or QA pipeline. Waterwheel Docker Page

Nested Agent Loops

Pair the agent with a code agent to wrap an autonomous browser test loop in a test-and-fix coding loop. Agent Loops

Skip the QA bottleneck

Run it yourself

Pull the Docker image, point it at your site, and ship with confidence. Free to run on your own machine.

docker pull taojdcn/duotail-waterwheel:1.3.0

Let your code agent drive

Add the skills to your code agent to run the full test-and-fix loop automatically.

npx skills add taodong/duotail-waterwheel-skills --skill '*'