Cypress Test Intelligence

Static analysis reports for your Cypress test suite — no test run required.

Scan your test files and instantly generate a rich HTML report with a health score, tag analysis, duplicate detection, and a full interactive test explorer. Works on .cy.js, .cy.ts, .spec.*, and .test.* files.

---

Preview

Sample report available here.

---

Features

• No test run needed — parses source files directly
• Health score — based on skipped and .only tests
• Tag analysis — distribution charts for @smoke, @regression, etc.
• Issue detection — flags empty suites and duplicate test/suite names
• Test Explorer — search, filter by tag/folder/modifier, sort, expand/collapse
• Dark & light themes — toggle in the report or set at generation time
• Fully self-contained — a single portable HTML file, no external dependencies

---

Installation

Global (run from any project)

npm install -g @alwaysonlabs/cypress-test-intelligence
cypress-test-intelligence --path cypress/e2e --open

Local (per project)

npm install --save-dev @alwaysonlabs/cypress-test-intelligence
npx cypress-test-intelligence --path cypress/e2e --open

---

Quick Start

Run from the root of your project (where cypress/ lives):

npx cypress-test-intelligence

This scans ./cypress/e2e, writes ./cypress-test-intelligence.html, and prints the output path. Open the file in any browser.

---

CLI Options

cypress-test-intelligence [options]
cypress-test-intelligence --config <file>

Flag	Description	Default
--config <file>	Load options from a JSON config file (CLI flags override)	—
--path <path>	Path to Cypress test files	cypress/e2e
--exclude <folders>	Comma-separated folder names to exclude	—
-o, --output <path>	Output HTML file path	./cypress-test-intelligence.html
-t, --title <text>	Report page title	Cypress Test Intelligence
--overview-text <text>	Custom description in the Test Overview section	built-in sentence
--logo <path|url>	Custom logo — local file path or URL	layers icon
--theme dark|light	Color theme	dark
--sort alpha|tests|size	Initial sort order in Test Explorer	alpha
--open	Open the report in a browser after generation	false
--no-support-button	Hide the "Buy me a coffee" button	shown
--no-environment	Hide the Environment section	shown
--no-tags	Hide all tag-related UI (see below)	shown
-h, --help	Show help	—

--no-tags in detail

When tags are not used in a project, pass --no-tags to produce a cleaner report. This removes:

• The entire Tag Analysis section
• The Tags filter dropdown in Test Explorer
• The Untagged filter tab in Test Explorer

--logo

Accepts a local file path (PNG, JPG, SVG, GIF, WebP) or any URL. Local files are embedded as base64 so the report stays self-contained.

# Local file
cypress-test-intelligence --logo ./assets/my-logo.png

# URL
cypress-test-intelligence --logo https://example.com/logo.svg

---

Config File

For repeatable or CI runs, store your options in a JSON config file and point to it with --config. Any CLI flag you pass alongside --config will override the corresponding value in the file.

npx cypress-test-intelligence --config report-options.json
npx cypress-test-intelligence --config report-options.json --open   # override: open after generation

Config file format

{
  "path": "cypress/e2e",
  "exclude": "cypress/examples,cypress/fixtures",
  "output": "./reports/test-report.html",
  "title": "My App — Test Report",
  "overviewText": "Automated test coverage for the billing and auth flows.",
  "logo": "./assets/logo.png",
  "theme": "dark",
  "sort": "alpha",
  "open": false,
  "showSupportButton": true,
  "showEnvironment": true,
  "showTags": true
}

All keys are optional and fall back to the same defaults as the CLI.

---

Examples

# Basic run, open in browser
npx cypress-test-intelligence --open

# Different test folder, light theme
npx cypress-test-intelligence --path src/tests --theme light --open

# Custom output path and title
npx cypress-test-intelligence -o reports/nightly.html -t "Nightly Suite"

# Exclude folders
npx cypress-test-intelligence --exclude "cypress/examples,cypress/fixtures"

# Project with no tags — clean report without tag UI
npx cypress-test-intelligence --no-tags

# Minimal report for CI (no support button, no environment footer)
npx cypress-test-intelligence --no-support-button --no-environment -o reports/ci.html

# Using a config file
npx cypress-test-intelligence --config report-options.json --open

---

npm Script Integration

Add a script to package.json so anyone on the team can generate the report with a single command:

{
  "scripts": {
    "test:report": "cypress-test-intelligence --config report-options.json --open"
  }
}

Then run:

npm run test:report

---

Report Sections

Section	Description
Test Overview	File, suite, and test counts; health score donut; skipped/only breakdown
Tag Analysis	Per-tag suite and test counts; multi-select filter with distribution charts
Issues	Empty suites, duplicate suite names, duplicate test names
Test Explorer	Full interactive list with search, folder/tag/modifier filters, sort, expand/collapse
Environment	Test path, Node.js version, platform, tool version, generation timestamp

---

Requirements

• Node.js 14 or later
• Cypress test files (.cy.js, .cy.ts, .spec.js, .spec.ts, .test.js, .test.ts)

---

License

MIT — AlwaysOnLabs