Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.openqa.io/llms.txt

Use this file to discover all available pages before exploring further.

​
OpenQA

An agent harness for browser test automation. Write your tests in plain English. Run npx openqa init. Done.
An agent harness (coined by Martin Fowler and described by Anthropic) is the infrastructure that wraps an AI model — connecting it to tools, managing its context, and steering its behaviour. OpenQA is that harness, purpose-built for browser testing.

No Code Required

Write feature files in plain English. The harness wires the AI agent to your browser automatically.

BDD & YAML Support

Works with Playwright-BDD, Cucumber.js, or simple YAML files — no step definitions to write.

No API Key Locally

Uses your existing claude login or opencode auth login session. API keys only needed for CI.

2-Minute Setup

npx openqa init scaffolds a complete .openqa/ harness into your existing project.

​
All You Need to Write

A .feature file: 
Feature: TodoMVC Automation

  Scenario: Add todo item
    * I navigate to "https://demo.playwright.dev/todomvc/"
    * I add a new todo item "Buy groceries"
    * I should see "Buy groceries" in the todo list
Then run: 
npx openqa init   # one-time setup
cd .openqa
npm run test:headed
That’s it. No step definitions. No selectors. No code.

Quickstart

Set up in 2 minutes.

Playwright-BDD

Gherkin feature files.

Cucumber.js

Standard Cucumber.

Examples

Browse example projects.