Known limitations

What you'll learn

The gaps that exist in the current release, why they exist, and what to do in the meantime.

Area	Limitation	Workaround
Visual baselines	Baselines are stored per Playwright project and platform (`features/__screenshots__/<project>/<platform>/`). The demo ships only the `chromium` / `darwin` baseline, so `@visual` fails on Linux CI until a Linux baseline is committed.	Run `automax run -t @visual --update-snapshots` once on each platform and commit the result.
Server ingest	`POST /api/runs/:id/ingest` accepts `run.json`, NDJSON and Playwright JSON only; an `artifacts.tgz` with screenshots is not accepted yet.	Ingest on the machine that produced the run, or share the artifacts directory.
Trace viewer	`/trace/*` is served from `node_modules/playwright-core/lib/vite/traceViewer`; under Bun's package layout that path may not resolve and the route returns `404`.	Open traces locally with `automax trace --last` (uses `playwright show-trace`).
Feature editor	Step completions come from the project's step catalogue; the `@cucumber/language-service` WebAssembly is loaded best-effort and may be unavailable, so semantic diagnostics fall back to the parser and server lint.	Diagnostics from `Save` and `Validate` are authoritative.
Auth capture	Two code paths exist: `automax auth capture` (dataset-row based) and the library `captureAuth()` used by `automax record --user`. Both produce the same files.	None needed; consolidation is scheduled.
`automax insights`	The CLI command is a placeholder. Metrics are computed by the database package and shown in the web UI dashboard and `GET /api/stats/insights`.	Use the web UI or the REST route.
Agents and MCP servers	The OpenAI-compatible adapter runs a plain tool loop and ignores `mcp.servers`; only the Claude adapter can drive the bundled Playwright MCP server.	Use the Claude adapter for browser-exploring roles (`plan`, `generate`, `heal`).
Third-party demo sites	The demo project targets public sandboxes (SauceDemo, JSONPlaceholder). Their session cookies live ten minutes; AutoMax refreshes cached login state automatically when cookies expire.	Use `--har-replay --strict` for fully offline runs.