qTest Integration

The SeaLights qTest Integration Tool connects your qTest test management platform to SeaLights. It gives you two capabilities:

1. Test execution reporting — Extract manual test results from qTest and report them to SeaLights so they contribute to coverage analytics and model training.
2. Test Optimization recommendations — SeaLights analyzes your code changes and identifies which tests can be safely skipped. The tool applies those recommendations in qTest by marking the relevant tests with a configured skip status (e.g. "SL Skipped").

Getting Started

• Quick Start — Get reporting in 5 steps
• Installation — Detailed prerequisites and setup
• Configuration — Full configuration reference

Commands

• Commands Overview

  • Setup Wizard
  • Report
  • Recommendations
  • User Mapping

Concepts

• Concepts Overview

  • Test Design Mapping
  • User Lab Mapping
  • Incremental Reporting

CI/CD

• CI/CD Integration

Troubleshooting

• Troubleshooting & FAQ

---

How It Works

qTest                         SeaLights qTest Tool              SeaLights
─────                         ────────────────────              ─────────
Test executions ──────────────► npm run report ──────────────► Coverage & model
(manual)                                                          training

                              npm run recommendations ◄──────── Test Optimization
qTest skip status ◄────────── (apply skip status)              recommendations

1. You run npm run report on a schedule. The tool fetches test executions from qTest and sends them to SeaLights.
2. Before a test cycle, you run npm run recommendations. SeaLights returns a list of tests that are safe to skip based on recent code changes. The tool marks those tests in qTest with the configured skip status.
3. Your testers run the tests, skipping the marked ones. After execution, you report the results again, closing the feedback loop.

Prerequisites

Requirement	Details
Node.js	v18 or later
qTest	Account with API access to the target project(s)
SeaLights	Agent token from your SeaLights account