<!-- Canonical page: https://docs.radforge.dev/cli/scope/ -->

# rad scope

Create a UTF-8 text file with one source path per line. Each path must be relative to the repository root:

```text
src/billing/entitlement.ts
src/billing/plans.ts
```

Then plan and execute it:

```bash
rad scope --scope-file mutation-scope.txt
```

Use `rad scope` when you or another tool has already selected the source files. Each path must stay inside the repository and name a supported TypeScript, JavaScript, or Python source file.

The command supports `--dry-run`, `--budget`, `--allow-broad-tests`, `--repo-root`, and `--json`. Hosted runs include only regular files tracked by Git. Radforge rejects a plan that names an untracked source file.
