# quell ci

> quell ci checks docstring and type requirements for coverage and exits 1 when the score is below --threshold, a fraction from 0.0 to 1.0.

Canonical page: https://quelltest.com/docs/cli/ci

`quell ci` computes the share of requirements in a path that have a covering test and exits with code 1 when that share is below `--threshold`. Use it as the pass or fail step in a Python CI pipeline. It does not write tests.

## What is the syntax?

```bash
quell ci [TARGET]
quell ci [TARGET] --threshold 0.75
```

| Option | Meaning |
| --- | --- |
| `TARGET` | File or directory to check (default `.`). |
| `--threshold FLOAT` | Minimum score as a fraction between 0.0 and 1.0 (default 0.0, which always passes). `0.75` means 75%. |
| `--root PATH` | Project root (default `.`). |

The command has no `--format` or `--no-write` option, and it does not read a threshold from `pyproject.toml`: always pass `--threshold`.

## What does it print?

```text
Quell Score: 0% | Threshold: 50%
FAIL: 0% < 50% threshold
```

```text
Quell Score: 100% | Threshold: 50%
PASS
```

## What is the score?

The fraction of requirements that have a covering test, read from docstrings (`Raises`, parameter constraints, `Returns`) and type annotations (Pydantic `Field` constraints, `Literal`, `Annotated`). The coverage checker is conservative and counts a requirement as uncovered when unsure. This is the same SDK check used by the Python API and the MCP tool `find_edge_cases`; it is a different measure from the Production Readiness Score printed by `quell find` and `quell score`.

## What are the exit codes?

| Code | Meaning |
| --- | --- |
| 0 | Score at or above the threshold. |
| 1 | Score below the threshold. |

## How do I use it in GitHub Actions?

```yaml
- uses: actions/setup-python@v5
  with:
    python-version: "3.11"
- run: pip install quelltest
- run: quell ci src/ --threshold 0.75
```

See the [GitHub Actions guide](https://quelltest.com/docs/guides/github-actions.md) and [CI/CD integration](https://quelltest.com/docs/guides/ci-integration.md). For JavaScript or TypeScript, use `quell score --threshold` and `quell gate` from the [npm CI guide](https://quelltest.com/docs/npm/ci.md).
