Skip to content

Analyze a file list with rad scope

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

src/billing/entitlement.ts
src/billing/plans.ts

For a Go scope, list only Go paths:

internal/billing/entitlement.go
internal/billing/plans.go

For a Python scope, list only production Python paths:

src/billing/entitlement.py
src/billing/plans.py

Then plan and execute it:

Terminal window
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 Go, TypeScript/JavaScript, or Python production source file. Every path in one scope must use the same language.

The command supports --dry-run, --budget, --allow-broad-tests, --repo-root, and --json. Hosted runs capture the final state of files tracked by Git, including safe symlinks. Radforge rejects a plan that names an untracked or deleted source file.

Hosted submission uses server-verified uploads and may transfer bytes directly to object storage. See Submit a run for transfer compatibility and Security for signed-URL boundaries.