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

## Commands

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

## Concepts

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

## CI/CD

* [CI/CD Integration](/knowledgebase/setup-and-configuration/integrations/qtest-integration/ci-cd-integration.md)

## Troubleshooting

* [Troubleshooting & FAQ](/knowledgebase/setup-and-configuration/troubleshooting-faq/qtest-integration.md)

***

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sealights.io/knowledgebase/setup-and-configuration/integrations/qtest-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.