# Cypress Parallel

🚀 A powerful tool to run Cypress tests in parallel across multiple processes, significantly reducing test execution time.

## Quick Start

### CLI Usage

# Run all tests with default settings

npx cypress-parallel-runner

# Run with 4 parallel processes

npx cypress-parallel-runner --concurrency 4

# Run specific test pattern

npx cypress-parallel-runner --spec "cypress/e2e/auth/\*_/_.cy.js"

# Run in Chrome browser with headed mode

npx cypress-parallel-runner --browser chrome --headed

# See what would run without executing

npx cypress-parallel-runner --dry-run

## CLI Options

| Option                         | Description                  | Default                |
| ------------------------------ | ---------------------------- | ---------------------- |
| \`-c, --concurrency <number>\` | Number of parallel processes | CPU cores              |
| \`-s, --spec <pattern>\`       | Spec file pattern to run     | From cypress.config.js |
| \`-e, --exclude <pattern>\`    | Pattern to exclude           | None                   |
| \`-b, --browser <browser>\`    | Browser to run tests in      | electron               |
| \`--config-file <file>\`       | Cypress config file          | cypress.config.js      |
| \`--headed\`                   | Run tests in headed mode     | false                  |
| \`--timeout <ms>\`             | Timeout per test file        | 300000                 |
| \`--cypress-command <cmd>\`    | Cypress command to use       | npx cypress            |
| \`--dry-run\`                  | Show files without running   | false                  |