Preflight Checks
The final wizard step is a system check the local agent runs against your machine and project. Green across the board means you're ready to test.
What gets checked
| Check | What the agent looks for |
|---|---|
| Node.js | node --version ≥ 20 |
| Git | git --version ≥ 2.30 |
| Filesystem | Read/write permissions in the project root and ~/.xyva/ |
| Playwright | @playwright/test resolvable; matching browser binaries on disk |
| Browser binaries | Chromium / Firefox / WebKit at the expected versions |
| Network | Outbound HTTPS to your AI provider endpoint (if connected) |
| Bridge | Active WebSocket session between agent and portal |
Resolving red checks
| Red check | Fix |
|---|---|
| Node < 20 | Install Node 20 LTS or 22 LTS, restart the agent |
| Git missing | Install Git for your OS, ensure it's in PATH |
| FS write blocked | Check antivirus/EDR, run the terminal with the right user |
| Playwright missing | npm install -D @playwright/test in the project |
| Browsers missing | Click Install browsers in the wizard, or run npx playwright install |
| Provider unreachable | Check proxy / VPN; see Proxy & Network |
| Bridge disconnected | Restart npx @xyva/agent start, refresh the portal |
The wizard re-runs each check automatically when you click Re-check, so you can fix things in another terminal and continue without restarting the wizard.
What "green" gives you
Once all checks pass:
- The portal opens the project Overview dashboard
- Test Hub lists your specs from the agent's filesystem
- Runner is ready to execute
- Swarm QA unlocks once you target a URL
- Brain lights up if AI was configured
Recommended flow
- Resolve any red checks before clicking Finish.
- Re-run preflight from Settings → System Status any time you change the agent's environment (Node upgrade, browser update, key rotation).
- Pin a baseline by exporting the preflight report — useful when onboarding teammates.