agent-qa

An AI QA engineer with memory: describe user journeys in plain language and agent-qa tests them on web and mobile, keeps the evidence, and improves from every run.

Stars
★ 894
Last updated
1d ago
License
NOASSERTION
Primary language
TypeScript

At a glance

How it runs
CLIWeb appMCP server
Works with
Universal · cross-platformCodex · Claude Code
Cost
Free software; you pay for model usage
Setup effort
Low · running in minutes
You'll need
Node.js 24+LLM API keyShell / CLINetwork accessLocal filesystemMCP Server
Typical use
Frontend teams catching regressions before shipping: write an 'add to cart → checkout' journey in plain language and see the failed cart-total assertion with its screenshot
Not a fit if
  • Teams that require a fully open-source license (FSL-1.1 has use restrictions)
  • Teams without a cloud LLM API key or unwilling to pay per-model usage
  • Teams needing a mature, stable tool: the project self-describes as early stage with expected bugs

What does this agent do, and when should you use it?

agent-qa is an open-source, self-improving QA agent from vostride, positioned as a test harness with memory for software teams. You write user-journey tests in natural language; it executes them on web, Android or iOS and keeps the evidence, used via a CLI, a dashboard, or through MCP and skills from your coding agent. Its memidex component stores facts and working procedures as reviewable files in your repository, and the system validates lessons from runs, retires stale knowledge, and corrects mistakes using your feedback. Published benchmarks rank it #1 on AndroidWorld (100% pass@1, 116/116 tasks) and #1 on AppControlBench (99.6% completion), both with gpt-6-sol and memory/self-improvement turned off. It is licensed under the Functional Source License (FSL-1.1-ALv2), and the project self-describes as early stage with expected bugs.

It reads natural-language user-journey tests, executes them step by step on web, Android or iOS via browser automation (playwright and browser-automation appear in its topics), and records failed steps with screenshots. The dashboard shows a failed assertion side by side with its recorded browser evidence, and a Knowledge tab shows which stored facts were retrieved for a run and traces them to the steps that used them. memidex persists facts and working procedures as reviewable files in your repository; after runs, agent-qa validates lessons, retires stale knowledge, and applies your feedback to fix mistakes. Interfaces include a CLI (run suites via npx agent-qa), the web dashboard, and an MCP server plus skills for coding agents.

  1. Frontend teams catching regressions before shipping: write an 'add to cart → checkout' journey in plain language and see the failed cart-total assertion with its screenshot
  2. Teams whose UI changes often: lean on memidex memory and adaptation to reduce selector-breakage rework
  3. Developers using coding agents like Claude Code or Codex: connect via the MCP server and skills so the agent can run and interpret tests
  4. Mobile teams validating end-to-end journeys on Android/iOS rather than only unit tests
  5. Teams that want test knowledge reviewable in-repo: memidex stores memory as files that fit code review

How do you install or deploy this agent?

Requires Node.js 24+. In your project directory run:

npm install -D agent-qa
npx agent-qa init

After init, follow the quickstart to connect a model and run the demo, or use the agent-quickstart to set it up with your coding agent.

How do you use this agent?

1) Run npx agent-qa init and connect a model per the quickstart; 2) write user-journey tests in natural language (e.g. a cart-to-checkout flow); 3) run the suite from your terminal with npx agent-qa — the CLI prints pass/fail per test and step progress; 4) open the dashboard to inspect failed steps with their screenshot evidence, and use the Knowledge tab to trace which memory was used by which steps; 5) alternatively connect agent-qa to your coding agent over MCP and let the agent run and interpret tests.

What are this agent's strengths and limitations?

Pros
  • Self-improvement loop: validates run lessons, retires stale knowledge, and corrects mistakes from your feedback, reducing post-UI-change maintenance
  • memidex stores memory as reviewable repo files, so test knowledge fits code review and version control
  • Public benchmark evidence: 100% pass@1 on AndroidWorld and 99.6% on AppControlBench, with run evidence and methodology published
  • Evidence-driven debugging: failed step and screenshot shown side by side; the Knowledge tab traces memory provenance
  • Multiple entry points: CLI, dashboard, MCP server and skills, fitting existing coding-agent workflows
Limitations
  • Licensed under FSL-1.1-ALv2 (Functional Source License), not an OSI open-source license; commercial use carries time limits and restrictions
  • The project self-describes as early stage and the README says to expect bugs
  • Requires connecting an LLM and paying per-use costs; the published benchmarks used gpt-6-sol
  • Requires Node.js 24+, so older CI or local environments need upgrading first
  • Benchmark results were achieved with memory and self-improvement off, which differs from the default usage mode

How does this agent compare with similar options?

The README names no direct competitors, but its playwright and end-to-end-testing topics and its 'memory + self-improvement' positioning clearly contrast with script-based E2E frameworks like Playwright or Cypress: those require hand-written, maintained selector scripts, while agent-qa takes natural-language journeys and adapts to UI changes — at the cost of LLM call expense and non-determinism.

Key facts side by side with the most closely related agents.

Agent Source review Form / cost Stars Updated Language Full support on
agent-qa This agent 49 · Major gaps CLIFree + model costs ★ 894 1d ago TypeScript Codex · Claude Code
Chrome DevTools MCP 79 · Some gaps MCP serverFree ★ 54k 2d ago TypeScript Codex · Claude Code
Kane CLI 71 · Some gaps CLIFreemium ★ 253 1d ago JavaScript Codex · Claude Code
Playwright Browser Automation MCP 60 · Some gaps MCP serverFree ★ 39k 3d ago TypeScript Codex · Claude Code

How does FollowAgents rate this agent?

FollowAgents source review · FARS-2.1
Major gaps
49/ 100 5-point scale 2.5 / 5
Trust 12/29
Reliability 9/14
Adaptability 9/18
Convention 9/18
Effectiveness 7/13
Verifiability 3/8
Why each dimension lost points
Trust12 / 29 · 2.1/5

Code shows path-resolved workspace file operations, atomic replace with symlink resolution, single-writer locks, and CI running with minimal GitHub permissions (contents: read); pnpm overrides pin numerous dependencies and onlyBuiltDependencies restricts build scripts — dependency_security earns 2. But for an agent that drives browsers/mobile and calls models, the repo documents no permission model, user confirmation flows, data flow to models, secret handling, or rollback of agent actions; the remaining trust criteria sit at 1. least_privilege: file managers appear workspace-scoped but no documented capability/permission surface for the agent itself (1). user_confirmation: no evidence of confirmation gates in provided files (1). data_flow_transparency: memory-as-reviewable-files is stated but what leaves the machine is not documented (1). sensitive_data_handling: a deleted test named 'declared-secret-masking-deleted' hints at masking but no substantive evidence (1). external_effects: browser/mobile automation with no consent/scope documentation (1). rollback: atomic writes are robust for files but nothing covers undoing agent-driven external effects (1).

Reliability9 / 14 · 3.2/5

CI is unusually thorough (sharded matrix, macOS legs, MCP conformance gating on its own exit code, documented timeout rationale), enforces --frozen-lockfile and pinned pnpm/node — dependency_availability 2. Validation returns structured errors with line/column/suggestion — failure_messages 2. The CI file's own comments admit that until 2026-08-02 every workflow was workflow_dispatch-only and the test-bearing Release workflow had never run, with green claims resting on local runs — a self-acknowledged consistency gap that caps self_consistency at 2.

Adaptability9 / 18 · 2.5/5

Audience (QA teams), scenarios (web/Android/iOS via CLI, dashboard, MCP/skills) and environment (Node 24+, pnpm 10.6.1, platform-specific macOS CI for BSD/proc differences) are clearly stated — audience_and_scenarios and environment_fit 2. Deducted: capability boundaries reduced to one line ('Early stage. Expect bugs') with no statement of where natural-language tests break down (capability_boundaries 1); trigger precision of the MCP/skills interfaces is undocumented (trigger_precision 1).

Convention9 / 18 · 2.5/5

Monorepo architecture is coherent, install steps are concrete, @vostride naming is consistent, and LICENSE.md is a complete FSL-1.1-ALv2 text matching the README badge — information_architecture, install_notes, naming_stability, license each 2. Deducted for: no in-repo CHANGELOG and no version field (versioning_changelog 1), no FAQ (examples_and_faq 1), known limitations limited to one sentence (known_limitations 1), no CONTRIBUTING/ownership files beyond a copyright line and issue link (maintenance_responsibility 1). Note the registry license metadata is NOASSERTION and FSL is source-available, not OSI open source.

Effectiveness7 / 13 · 2.7/5

README shows real CLI output, failure evidence side-by-side with screenshots, and a knowledge-traceability panel — output_usability 2. Memory + validated self-improvement for QA is a differentiated angle — marginal_value 2. Deducted: nothing on model costs, run/token overhead, or ROI versus existing E2E tooling — cost_benefit 1.

Verifiability3 / 8 · 1.9/5

Benchmark claims (AndroidWorld 100% pass@1, AppControlBench 99.6%, '#1' ranks, gpt-6-sol) resolve only to the publisher's own blog, with no run evidence, reproduction scripts, or raw results inside the repository — claim_traceability and cross_source_corroboration 1. Claims and facts are not separated in the README; only the CI comments carry traceable issue-numbered factual context — fact_inference_separation 1.

Risks and how to mitigate them
  • License is FSL-1.1-ALv2 (source-available, not OSI open source) with competing-use restrictions; obtain legal sign-off before commercial adoption. Registry metadata is NOASSERTION.
  • Benchmark claims (#1, 100% pass@1, etc.) live only on the publisher's self-hosted blog with no reproducible evidence in the repo; treat as unverified marketing.
  • The agent drives real browsers/mobile devices and calls external models; data sent to models, secret handling, and rollback of external effects are undocumented — assess before adoption.
  • The project self-describes as early stage, and CI comments admit tests barely ran automatically before 2026-08-02; historical green claims are not trustworthy.
  • Publisher identity is unverified; the only accountability artifact is a single copyright line.
Evidence confidence: Low Reviewed Oct 25, 2026 Reviewed revision 33cd7dbe52f7
See the full review method →

FAQ

Which models and keys does it need?
It needs a connected LLM (configured via the quickstart); the published benchmarks used gpt-6-sol. Model usage is billed per call against your API key.
What platforms does it test?
The README says tests run on web, Android or iOS; separate docs cover connecting to coding agents like Claude Code and Codex via MCP and skills.
Where does memory live, and will it clutter my repo?
memidex stores facts and procedures as reviewable files in your repository; you can review, edit, or delete them like any code change.
How do I debug a failed test?
The dashboard shows the failed assertion, the failed step, and the recorded screenshot side by side; the Knowledge tab traces which memory was retrieved and where it was used.
Is it production-ready?
The project calls itself early stage with expected bugs; the license is FSL-1.1-ALv2, so read its terms and restrictions before commercial adoption.
View on GitHub ↗ Install ↓

Compare agents like this one

The same FARS review applied across the shortlist this agent qualifies for.

Related agents