Quickstart
The fastest path to your first Agentiqa test — pick a surface and run.
Pick the surface that fits how you want to work — they all drive the same agent.
Web app
- Open the Agentiqa web app and sign in.
- Create a project by entering the URL of the app you want to test (and a name).
- Open the Assistant and ask for what you want — for example "Test the signup flow" or "What can you test here?"
- Review the agent's scope and plan checkpoints, then confirm the findings it reports.
Cloud execution runs the browser on Agentiqa's infrastructure — nothing to install.
Desktop app
- Download the desktop app (see Desktop App) and sign in.
- Create a project with your app's URL.
- Ask the Assistant to test it. The desktop app drives a built-in headed browser, so you can watch the agent work.
The desktop app has the full capability set — see Desktop vs Web.
CLI
Requires Node.js 18+ (Node 20 recommended).
# Explore a URL with the agent (in-process engine)
npx -y agentiqa@latest explore "Find bugs on this page" --url https://example.com
# Run saved test plans against the hosted cloud engine (CI-friendly)
AGENTIQA_SERVICE_KEY=sk_... npx -y agentiqa@latest run --engine https://engine.agentiqa.comSee the CLI guide and the generated CLI reference. To run a labeled subset or run plans in parallel, see Labels and Parallel runs.
Coding agent
Already working in Claude Code, Cursor, or Codex? Drive Agentiqa from there: your coding agent explores, you review the draft plan in chat, and it saves and runs the plan for you — the same agent proposes, you curate loop, on the command line.
-
Install the Agentiqa plugin. In Claude Code:
/plugin marketplace add Agentiqa/agentiqa-plugin /plugin install agentiqa@agentiqa -
Create a project-scoped service key in Project Settings → CLI Service Keys and expose it to your agent's shell as
AGENTIQA_SERVICE_KEY(never paste it into chat). -
Ask your agent to test something — for example "Explore the checkout flow and draft a plan." It runs the exploration, shows you the draft, and on your explicit approval saves the plan (
tp_…) and runs it.
See Agent skill for the full explore → review → save → run → revise loop, other coding agents (Cursor, Codex), and how the plan hands off to CI.
GitHub Action
Run your saved plans in CI and gate the job on the outcome:
- uses: agentiqa/qa-action@v1
with:
service-key: ${{ secrets.AGENTIQA_SERVICE_KEY }}See the GitHub Action guide and CI Integration.