Matware E2e Runner

What is Matware E2e Runner?

Matware E2e Runner is an AI-native, zero-code browser testing framework where tests are plain JSON files. It integrates deeply with AI via an MCP server, enabling Claude Code to create, run, and debug tests conversationally. It is designed for teams that want to write and maintain end-to-end tests without learning Playwright, Cypress, or any test framework.

How to use Matware E2e Runner?

Install via npm install --save-dev @matware/e2e-runner, then run npx e2e-runner init to create a sample test directory, npx e2e-runner pool start to launch a shared Chrome pool in Docker, and npx e2e-runner run --all to execute tests. Configure your app’s port in e2e.config.js. Optionally add Claude Code integration with claude plugin marketplace add fastslack/mtw-e2e-runner to get 13 MCP tools.

Key features of Matware E2e Runner

• Zero-code tests written as JSON files.
• AI-powered test creation and debugging via MCP.
• Issue-to-Test pipeline from GitHub/GitLab URLs.
• Visual verification by describing expected page appearance.
• Parallel execution against a shared Chrome pool.
• Real-time dashboard with run history and screenshots.

Use cases of Matware E2e Runner

• Create and run E2E tests by describing the flow in natural language.
• Paste a bug report URL and get a runnable test that confirms the issue.
• Run multiple tests in parallel across different CI or development environments.
• Monitor test stability and detect flaky selectors or error patterns.
• Extract common login or navigation flows into reusable modules.

FAQ from Matware E2e Runner

How are tests defined?

Tests are JSON files containing an array of test objects, each with a name and an array of actions like goto, click, type, and assert_text. No JavaScript or imports required.

What are the runtime prerequisites?

Node.js >= 20 and Docker must be running. Your application must be accessible on a known port, and Chrome executes inside Docker using host.docker.internal to reach your app.

How does AI integration work?

An MCP server provides 13 tools to Claude Code, allowing it to create tests, run them, capture screenshots, visually verify pages, and debug failures — all from a chat interface.

How are tests executed?

Tests run in parallel against a shared Chrome pool managed via Docker (browserless/chrome). Serial mode is available for tests that share state.

Does Matware E2e Runner support retries and CI?

Yes. Test-level and action-level retries are configurable. CI output includes JUnit XML, exit code 1 on failure, and auto-captured error screenshots.