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

# rad file

<!-- GENERATED FILE. Run npm run generate in documentation/. Do not edit by hand. -->

> Released CLI binaries build plans locally and send them to Radforge for execution.

```text
Usage: rad file <path> [options]

Plan one source file locally, then run its mutation analysis with the local executor.

Options:
  --repo-root <path>      Repository root. Defaults to the current working directory.
  --artifact <path>       Submit an existing mutation plan.
  --mode <mode>           Local execution mode. Defaults to full.
  --dry-run               Print the generated plan without submitting it.
  --budget <count>         Limit mutation candidates in the generated plan.
  --allow-broad-tests      Allow a broad test set when narrow selection fails.
  --json                  Render JSON output.
```
