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

The open-source agentic testing harness for browser 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. Built for agentic engineering workflows — the same agent that builds your product can verify it.

No Selectors. Ever.

The agent navigates by intent. No CSS selectors, no XPath, no brittle locators to maintain. Survives any UI refactor automatically.

CI-grade Evidence

Full HTML report, trace viewer, and screenshot diffs on every run. Ship to production with proof, not hope.

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
    * Navigate to "https://demo.playwright.dev/todomvc/"
    * Add a new todo item "Buy groceries"
    * 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.

How It Works

Architecture and design decisions.

GitHub

Source code and examples.

npm

Package on npm.