AutoMax
ReferenceCLI commands

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]
FlagMeaning
pathapplication 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
--applywrite the proposed project under projects/<slug>
--forceoverwrite an existing project when applying
--no-import-specsdo not copy existing Playwright specs into recorded/imported
--report-onlyprint 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 @smoke

automax init --from <app> runs the same analysis while scaffolding a new workspace.