QAwalk

Guides

How teams run QA with their agent: what to install, what to ask, what comes out. Each guide ends with a live demo run and the three install steps.

By use case

Accepting a task with an AI agent, in the pull request

The agent walks the acceptance plan on local or review, QAwalk captures every screen and e-mail, checks the criteria and puts one canvas link into the PR. The reviewer accepts or returns it there.

Read the guide →
Regression before a release: compare the run with the accepted baseline

Run the flows against staging, compare with the baseline run the team accepted, and see what moved: step statuses, criteria, evidence, pixels.

Read the guide →
SEO and landing-page checks on production, read-only, every day

A read-only run of your public pages as a visitor: headings, metadata, hreflang, Open Graph, structured data, overflow, console. Shared, compared with yesterday, fixed before anyone else notices.

Read the guide →
E-mail flows: capture the message next to the screen that sent it

Sign-up confirmation, order receipt, password reset. QAwalk captures the e-mail from Mailpit or letter_opener as a step of the flow, checks its subject and links, and shows it on the canvas next to the form.

Read the guide →

By agent

QA with Claude Code: install the skill, ask in plain words, read the canvas

How Claude Code runs QAwalk: the skill it installs, what it may do without asking, what it asks first, the prompts that work, and how it reads reviewer feedback and the inbox.

Read the guide →
QA with Codex: the skill in skills/qawalk and a pointer in AGENTS.md

How Codex runs QAwalk: where the skill lives, how AGENTS.md points to it, the prompts that work, and how Codex reads reviewer feedback before it continues.

Read the guide →
QAwalk in CI: headless runs, read-only tokens, one comment per scenario

Run the same walkthrough from GitHub Actions or any CI: bundled Chromium, a tester token to share, a read-only token to read, results in the PR and on the canvas.

Read the guide →

Skills and tools

Skill catalog: the qawalk skill, its references, and the tools we recommend next to it

What the qawalk skill makes an agent do, what each reference covers, and which third-party skills and tools fit alongside, each with its implications: what runs where, which data leaves the machine, when not to use it.

Read the guide →

What it looks like

A real run of QAwalk on its own public pages, refreshed daily. This is the canvas your team gets.

6 of 6 steps passed · 2026-09-24Open the run in QAwalk ↗

Install in three steps

QAwalk runs where your code and your agent are. The service stores and versions the results, shows the canvas and collects approvals.

  1. Add the CLI to the project
    npm install --save-dev github:sinfin/qawalk#v0.1.0

    Pre-launch: the repository is private. Ask Sinfin for access.

  2. Create the config and install the skill
    npx qawalk init --agent claude --org <your-org>
    npx qawalk doctor

    The skill is copied to .claude/skills/qawalk.

  3. Create your organization and a token

    Create an organization; you become its admin. The start page offers a tester token in one click, later under Settings → API tokens. Put it into the project .env:

    QAWALK_TOKEN=qwk_…
    TYPESAFE_API_KEY=…   # optional: semantic evaluator
  4. Run and share
    npx qawalk start --scenario docs/tasks/TASK-123/qa/scenario.yml --env local
    npx qawalk walk        # playwright steps; agent/manual steps: qawalk capture
    npx qawalk evaluate
    npx qawalk share --pr

    Or ask your agent: “Walk the acceptance plan of TASK-123 with QAwalk on local and share the result.”