automax analyze
Analyze an application repository and propose an AutoMax project.
automax analyze [path] [-p <slug> | --slug <slug>] [--name <name>] [--openapi <file>] [--browsers <list>]
[--apply] [--force] [--no-import-specs] [--report-only]| Flag | Meaning |
|---|---|
path | application repository (default: current directory) |
-p, --project <slug> | slug for the proposed project (default: from the app directory name); --slug alias |
--name <name> | display name |
--openapi <file> | OpenAPI spec path relative to the app (auto-detected otherwise) |
--browsers <list> | comma list of browsers for the proposal |
--apply | write the proposed project under projects/<slug> |
--force | overwrite an existing project when applying |
--no-import-specs | do not copy existing Playwright specs into recorded/imported |
--report-only | print the analysis and skip the proposal |
Read-only unless --apply. Detects the package manager and monorepo shape, the framework, routes (Next.js, React Router, Vue Router, Nuxt, Angular, Express, Fastify, NestJS, Spring, Flask, FastAPI, Django), OpenAPI documents, the test-id attribute in use, existing tests and their locator quality, authentication libraries and login pages, env files and dev-server ports, CI provider, i18n and accessibility tooling. The proposal contains a validated automax.project.yaml (modules by route segment or OpenAPI tag, processes, routes), envs/*.yaml, starter @smoke features per module, a coverage map and a checklist.
bun run automax analyze ../my-app --report-only
bun run automax analyze ../my-app --apply --slug my-app
bun run automax lint -p my-app && bun run automax run -p my-app -e local -t @smokeautomax init --from <app> runs the same analysis while scaffolding a new workspace.