# Python CLI overview

> Reference list of the quell commands in the quelltest PyPI package, with what each does, which are deprecated, and links to detailed pages.

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

The `quell` command from the PyPI package has one primary command, `quell find`, and a set of utilities for scoring, CI, setup, pull requests, graph inspection, authentication and cloud sync. This page lists them as printed by `quell --help` in the repository at version 2.0.1. For the npm package's `quell` command, see the [npm CLI reference](https://quelltest.com/docs/npm/cli.md).

## What are the commands?

| Command | Purpose | Details |
| --- | --- | --- |
| `quell find [TARGET]` | Find untested edge cases. `--fix` writes tests for confident cases. | [quell find](https://quelltest.com/docs/cli/find.md) |
| `quell score [TARGET]` | Show the Production Readiness Score. `--badge` prints an SVG, `--json` prints JSON. | [quell score](https://quelltest.com/docs/cli/score.md) |
| `quell reproduce "<bug>"` | Convert a bug description into a verified failing test. | [quell reproduce](https://quelltest.com/docs/cli/reproduce.md) |
| `quell prove FILE` | Show the share of requirements proven for a file or function (`--function`). | below |
| `quell ci [TARGET]` | CI mode: exit 1 when the score is below `--threshold`. | [quell ci](https://quelltest.com/docs/cli/ci.md) |
| `quell init` | Add a `[tool.quell]` block to `pyproject.toml`. | [quell init](https://quelltest.com/docs/cli/init.md) |
| `quell install` | Set up a pre-commit hook and a GitHub Actions workflow. | [quell install](https://quelltest.com/docs/cli/install.md) |
| `quell pr PR_NUMBER` | Analyze requirement coverage for a GitHub pull request (`--comment`, `--fix`, `--repo`, `--token`, `--format json`). Reads `GITHUB_TOKEN`. | below |
| `quell auth` | Manage credentials: `login`, `logout`, `set`, `status`. | [quell auth](https://quelltest.com/docs/cli/auth.md) |
| `quell mcp` | Run the local MCP server on stdio. | [MCP server](https://quelltest.com/docs/mcp.md) |
| `quell graph` | QuellGraph subcommands: `build`, `show`, `why`, `stale`, `stats`. | below |
| `quell sync` | Cloud sync (Pro and Team): `push`, `status`, `history`, `unlink`. | [Connector](https://quelltest.com/docs/connector.md) |
| `quell teardown` | Stop and remove quelltest-managed ephemeral containers. | below |

Global option: `--version` / `-V` prints `quelltest <version>`.

## Which commands are deprecated?

`quell scan` and `quell check` still exist but print a deprecation notice: use `quell find`. They will be removed in v2.2.

## What do the smaller commands do?

- `quell prove src/payments.py --function process_payment` prints the percentage of requirements proven for that file or function.
- `quell pr 42 --comment` analyzes pull request 42 (repository detected from the git remote unless `--repo owner/repo`) and can post the result as a comment. Set `GITHUB_TOKEN` or pass `--token`; the token needs the `repo` and pull request scopes.
- `quell graph build src/` builds or incrementally updates a code-intelligence index at `.quellgraph/graph.db`; `graph show`, `graph why FUNCTION`, `graph stale` and `graph stats` inspect it.
- `quell teardown` stops containers that quelltest started for verification (tracked in `.quellgraph/containers.lock`).

Most commands accept `--root PATH` (default `.`) for the project root.

## Which exit codes do they use?

`quell ci` exits 1 below the threshold; `quell find` exits 0 whether or not gaps were found. Commands that fail on missing input or configuration exit 1. Details are on each command page.
