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

# Scanning

> CLI commands for running AST-based code scans to detect LLM usage patterns.

All scan commands live under the `scan` group (alias: `s`).

```bash theme={"system"}
valiqor scan <run>
# or
valiqor s <run>
```

***

## scan run

Run an AST-based context scan on your repository to detect LLM providers, entry points, and usage patterns.

```bash theme={"system"}
valiqor scan run [path] [flags]
```

| Flag               | Type         | Default                 | Description                   |
| ------------------ | ------------ | ----------------------- | ----------------------------- |
| `path`             | `positional` | `.` (current directory) | Path to the directory to scan |
| `--verbose` / `-v` | `flag`       | `false`                 | Show detailed scan output     |

### Examples

```bash theme={"system"}
# Scan the current directory
valiqor scan run

# Scan a specific directory with verbose output
valiqor scan run ./src --verbose
```

### Behavior

* If no `.valiqorrc` exists, the CLI auto-configures the project before scanning.
* The scan results are saved to the configured `scan_dir`.

<Info>
  Requires the `valiqor.scanner` module. Run `valiqor --version` to check availability.
</Info>