# 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](https://docs.sealights.io/knowledgebase/setup-and-configuration/integrations/qtest-integration/quick-start) — Get reporting in 5 steps
* [Installation](https://docs.sealights.io/knowledgebase/setup-and-configuration/integrations/qtest-integration/installation) — Detailed prerequisites and setup
* [Configuration](https://docs.sealights.io/knowledgebase/setup-and-configuration/integrations/qtest-integration/configuration) — Full configuration reference

## Commands

* [Commands Overview](https://docs.sealights.io/knowledgebase/setup-and-configuration/integrations/qtest-integration/commands)
  * [Setup Wizard](https://docs.sealights.io/knowledgebase/setup-and-configuration/integrations/qtest-integration/commands/setup)
  * [Report](https://docs.sealights.io/knowledgebase/setup-and-configuration/integrations/qtest-integration/commands/report)
  * [Recommendations](https://docs.sealights.io/knowledgebase/setup-and-configuration/integrations/qtest-integration/commands/recommendations)
  * [User Mapping](https://docs.sealights.io/knowledgebase/setup-and-configuration/integrations/qtest-integration/commands/manage-user-mapping)

## Concepts

* [Concepts Overview](https://docs.sealights.io/knowledgebase/setup-and-configuration/integrations/qtest-integration/concepts)
  * [Test Design Mapping](https://docs.sealights.io/knowledgebase/setup-and-configuration/integrations/qtest-integration/concepts/test-design-mapping)
  * [User Lab Mapping](https://docs.sealights.io/knowledgebase/setup-and-configuration/integrations/qtest-integration/concepts/user-lab-mapping)
  * [Incremental Reporting](https://docs.sealights.io/knowledgebase/setup-and-configuration/integrations/qtest-integration/concepts/incremental-reporting)

## CI/CD

* [CI/CD Integration](https://docs.sealights.io/knowledgebase/setup-and-configuration/integrations/qtest-integration/ci-cd-integration)

## Troubleshooting

* [Troubleshooting & FAQ](https://docs.sealights.io/knowledgebase/setup-and-configuration/troubleshooting-faq/qtest-integration)

***

## 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          |