Test CLI Commands Reference

Test Generation

maeris test generate

Scans your codebase and generates a Playwright test suite covering all discovered user flows.

maeris test generate maeris test generate --url http://localhost:3000 maeris test generate --url http://localhost:3000 --exclude "node_modules,dist"

Test Execution

maeris test run

Runs test cases with the AI-powered auto-fix loop. Automatically repairs failing selectors and retries until tests pass.

# Run all tests maeris test run # Run a specific test by name maeris test run --name login_valid_credentials # Run all tests in a folder maeris test run --folder Authentication # Run smoke tests only maeris test run --smoke # Run full regression suite maeris test run --regression

maeris test fix

Runs the AI fix loop on a specific failing test without executing the whole suite.

maeris test fix --name <test-name>

maeris test recalibrate

Re-scans the codebase after significant UI changes and bulk-updates selectors in all affected tests.

maeris test recalibrate

Test Management

maeris test list

Lists all test cases in the current application. Use --remote to list tests synced to the portal.

maeris test list maeris test list --folder Authentication maeris test list --remote

maeris test get

Displays the full details of a specific test case including all steps, selectors, and last run result.

maeris test get <test-name> maeris test get login_valid_credentials

maeris test edit

Opens an interactive editor to update the test name, description, folder, or tags.

maeris test edit <test-name> maeris test edit login_valid_credentials --tag smoke

maeris test step edit

Edits an individual step within a test case. Useful for manually updating a selector or changing an assertion value.

maeris test step edit <test-name> # Opens interactive step editor for the specified test

maeris test import

Imports tests from Playwright, Cypress, or Selenium files into Maeris.

maeris test import <file> maeris test import tests/auth.spec.ts maeris test import tests/ --folder Authentication

maeris test delete

Deletes a test case from the local application context. Use --remote to also delete from the portal.

maeris test delete <test-name> maeris test delete login_valid_credentials --remote

Folder Management

maeris folder create

Creates a new folder for organizing test cases.

maeris folder create Authentication maeris folder create "Checkout Flow"

maeris folder list

Lists all test folders and the number of tests in each.

maeris folder list

maeris folder delete

Deletes a folder. Tests inside are moved to the root (unfoldered) by default.

maeris folder delete Authentication maeris folder delete Authentication --delete-tests  # also deletes contained tests

Pushing Tests

maeris push tests

Syncs local test cases and results to the Maeris Portal.

maeris push tests maeris push tests --folder Authentication

Next Steps