> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qlty.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# slop-one

This reference documents Qlty CLI v0.656.0.

```bash lines theme={"system"}
qlty slop-one [OPTIONS] [FILES]...
```

Build the SlopOne code quality trends report, or score source files

## Arguments

<AccordionGroup>
  <Accordion title="[FILES]...">
    Source files to score; with none, build the trends report for this repository
  </Accordion>

  <Accordion title="--offline">
    Use existing cached analyses; make no API calls
  </Accordion>

  <Accordion title="--budget <BUDGET>">
    Maximum estimated API spend for this invocation in USD (default: 1 when scoring files, no cap for the report)
  </Accordion>

  <Accordion title="--provider <PROVIDER>">
    Jev provider: typesafe (direct), vercel (AI Gateway), or openrouter

    \[default: typesafe] \[possible values: typesafe, vercel, openrouter]
  </Accordion>

  <Accordion title="--cache-dir <CACHE_DIR>">
    Directory for cached analyses and run data (default: \~/.qlty/cache/slop-one)
  </Accordion>

  <Accordion title="--jobs <JOBS>">
    Number of files or contents to analyze concurrently

    \[default: 16]
  </Accordion>
</AccordionGroup>

### Report options

<AccordionGroup>
  <Accordion title="--since <SINCE>">
    Start of the report, YYYY-MM-DD (default: one year ago)
  </Accordion>

  <Accordion title="--output <OUTPUT>">
    Directory for the report (default: the working directory)
  </Accordion>

  <Accordion title="--no-open">
    Write the report without opening it in the browser
  </Accordion>
</AccordionGroup>

### Scoring options

<AccordionGroup>
  <Accordion title="--json">
    Emit one JSON result object
  </Accordion>

  <Accordion title="--include-tests">
    Include test files and Rust inline test modules (excluded by default)
  </Accordion>

  <Accordion title="--include-excluded">
    Include generated, dependency, documentation, and test files; also include inline tests
  </Accordion>

  <Accordion title="--model-info">
    Show model metadata without evaluating files
  </Accordion>

  <Accordion title="--top <TOP>">
    Number of positive and negative factors in text output (default: 3, or 5 when comparing)
  </Accordion>
</AccordionGroup>

### Comparison options

<AccordionGroup>
  <Accordion title="--upstream <REF>">
    Compare the files changed since the merge base with REF against their versions there
  </Accordion>

  <Accordion title="--upstream-from-pre-push">
    Compare the commits being pushed, read from a Git pre-push hook's stdin
  </Accordion>

  <Accordion title="--max-drop <POINTS>">
    Largest score drop allowed before a changed file counts as declined (default: 1)
  </Accordion>

  <Accordion title="--trigger <TRIGGER>">
    What runs the comparison; pre-push reports a blocked push, lets errors through, and can be skipped with Enter

    \[default: manual] \[possible values: manual, ide, agent, pre-commit, pre-push, build]
  </Accordion>

  <Accordion title="--prompt <MODE>">
    What the prompt printed for declined files asks a coding agent to do (default: recommend)

    \[possible values: recommend, refactor]
  </Accordion>
</AccordionGroup>

## See Also

* [Global Options](/cli/global-options)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.