> For the complete documentation index, see [llms.txt](https://stackpi-intelligent.gitbook.io/stackpi-intelligent/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://stackpi-intelligent.gitbook.io/stackpi-intelligent/stackpi-intelligent-cover/feature-flags.md).

# Feature Flags

StackPi Intelligent

Use Feature Flags to unlock more capabilities of StackPi Intelligent Cover.

**1. Diff-Based Coverage**

Generate tests for changes made between branches, ensuring that new code is thoroughly tested without the need to run the entire test suite again.

* **Options**:
  * `--diff-coverage`: Enables diff-based test generation.
  * `--branch=<branch_name>`: Specifies a branch for comparison (default: `main`).
* **Usage**:

  Copy

  Copy

  ```
  python cover_agent/main.py --diff-coverage --branch=develop
  ```

  This example compares the current branch with `develop`, generating tests for new changes.
* **Note**: `--diff-coverage` cannot be used with `--use-report-coverage-feature-flag`.

**2. Report-Based Coverage**

Accept tests if they increase coverage for any file included in the report, regardless of the specific source file.

* **Option**:
  * `--use-report-coverage-feature-flag`: Activate this feature to accept any coverage increase.
* **Usage**:

  Copy

  Copy

  ```
  python cover_agent/main.py --use-report-coverage-feature-flag
  ```

  This example accepts tests that improve coverage anywhere in the report.
* **Note**: This flag is mutually exclusive with `--diff-coverage`.
