This documentation is available as Markdown. For the complete index, see llms.txt. Skip to content
unotest

Quick start — web

For the complete documentation index, see llms.txt
View Markdown Open in ChatGPT Open in Claude

Get your first test written and running in a few minutes. Works with any backend stack (Node, Django, Rails, Go…) — no package.json required.

1. Initialize

Run once in your project:

Terminal window
npx @unotest/web init

init writes the config and a starter scenario, sets up the browser (bundled Chromium, or your system Chrome if you pick it), and wires the MCP server so Claude Code / Cursor / Codex pick it up automatically. Re-run anytime — it never overwrites your edits.

2. Open the viewer

Terminal window
npx @unotest/web viewer

A local IDE-style UI for your tests — no cloud, no account. Browse scenarios, run them, and watch each step live. This is your home base.

3. Ask your agent for a test

In your AI editor, open your project and describe the flow in plain English:

Open my app, sign in as the demo user, and check that the dashboard heading appears.

Through the MCP server the agent explores your live app — clicking, filling, reading the real DOM — then writes a clean scenario to unotest/e2e/<name>.js with stable selectors, runs it, and debugs itself if it fails.

function test_login() {
  step("Sign in as the demo user", () => {
    goto("/login");
    fill(getByLabel("Email"), TEST_USER_EMAIL);
    fill(getByLabel("Password"), TEST_PASSWORD);
    click(getByRole("button", { name: "Continue" }));
  });


  step("Dashboard is shown", () => {
    assertVisible(getByRole("heading", { name: "Dashboard" }));
  });
}

4. Run it

Click any scenario in the viewer, or from the CLI:

Terminal window
npx @unotest/web e2e login

5. Review & commit

You get a reviewable .js test. Read it, tweak it, commit it. That’s the whole loop — the agent does the legwork, you own the result.

Next