How it fits together

You drive Global Assert with the xqa CLI. Agents explore the app, consolidate findings, triage PRs, and plan coverage — then write results you can review and share.

Product layers

Top to bottom: what you run, what runs the tests, what drives the device, what you get back.

You
X
xqa CLI
@assertmind/qa
Commands for explore, spec, run, plan, triage, review, and report.
Orchestration
P
Pipeline & suite
xqa run / explore / spec
Runs Explorer, optional video review, then Consolidator — in parallel across simulators for suites.
Agents
E
Explorer
navigate + observe
Drives the simulator from a prompt or spec; optional visual checks while exploring.
C
Consolidator
dedupe findings
Merges findings, applies dismissals, writes findings.json.
T
Triager
xqa triage
Matches a PR diff to the suites worth running.
Read docs →
L
Planner
xqa plan
Turns a branch diff into reviewable test scenarios.
Read docs →
Device & output
M
Device
simulator / Appium
Install, launch, tap, screenshot, and read the UI tree.
D
Display
terminal / CI
Live progress dashboard or greppable CI logs.
F
Findings
.xqa/output
Structured findings, videos, and reports you can review or post to a PR.

Optional capabilities (video recording, visual pass, post-run video review) are configured in .xqa/config.yaml — see the user guide for setup.

Commands you use

Published binary: @assertmind/qa → xqa.

Command Layer What it does
xqa init setup Create .xqa/ project files
xqa explore / spec run Freestyle or spec-guided exploration on a device
xqa run run Suite or glob of specs across booted simulators
xqa plan plan Generate, edit, or extend scenarios from a git diff
xqa triage triage Pick suites for a PR; optional labels
xqa review findings Dismiss false positives interactively
xqa report / share findings Post a PR report or share a hosted run link

Reading the diagram

You CLI entry — install once, run from your project.
Orchestration Suite and single-run pipelines that schedule agents on devices.
Agents Explorer, Consolidator, Triager, Planner — the product behaviors.
Device & output Simulators, terminal progress, findings artifacts.