Project Import

The third wizard step tells the portal which project the local agent should work against. The agent does the actual filesystem scan and reports back over the WebSocket bridge.

What gets detected

When you point the agent at a project root, it parses:

• playwright.config.ts / .js — projects, baseURL, reporter, retries
• package.json — Playwright version, scripts (test, e2e, test:e2e)
• File tree — POMs, fixtures, helpers, test specs
• node_modules and Playwright browser binaries

The portal renders a summary card with counts and links straight into the Test Hub.

Three ways to import

1. Use the agent's working directory

The simplest case. You started the agent with --project . from the project root; the wizard offers it as the default import.

2. Pick another path

The agent can serve multiple paths if you started it with --project /path/to/parent. The wizard lists subdirectories that contain a Playwright config.

3. Initialise a new project

If the path has no Playwright config, click Initialise. The agent runs:

npm init playwright@latest

You pick TypeScript or JavaScript, the test directory, and whether to add a GitHub Actions workflow. The agent streams the install output into the portal.

Multi-project workflows

You can connect the portal to multiple agents on the same machine, each pointing at a different project:

# In one terminal
npx @xyva/agent start --project ~/code/shop --port 7900

# In another
npx @xyva/agent start --project ~/code/admin --port 7901

Switch between them from the Agent badge in the portal top bar. Each agent has its own Wizard state, AI provider settings and run history.

Recommended flow

1. Run the agent in the project root before opening the wizard.
2. Confirm the detected Playwright version and baseURL.
3. Open the Test Hub to verify your specs are visible.
4. Continue to Preflight Checks.

Troubleshooting

Symptom	Fix
No Playwright config found	Make sure you point at the project root, not the workspace root
Specs missing in tree	Check testDir in playwright.config.ts
Agent unresponsive	Restart with npx @xyva/agent start --project .
Wrong project shown	Stop the agent (Ctrl+C) and restart with the right --project path

What to read next

• Preflight Checks
• Local Agent Setup
• Run History