Skip to content
Docs

Analyze one file with rad file

Target one Go, TypeScript/JavaScript, or Python production source file relative to the repository root:

Terminal window
rad file src/billing/entitlement.ts

For Go, point to a production .go file under a go.mod module or go.work workspace:

Terminal window
rad file internal/billing/entitlement.go

For Python, point to a production .py file in a pytest project with pyproject.toml and uv.lock:

Terminal window
rad file src/billing/entitlement.py

The CLI builds the plan locally and submits it for hosted execution. Use --dry-run --json to inspect or save the plan without submitting it.

Terminal window
rad file src/billing/entitlement.ts --dry-run --json > plan.json
rad remote run --artifact plan.json

--budget limits the number of mutation candidates. --allow-broad-tests lets Radforge run a broad test set when it cannot select a smaller one. This can take longer and run more tests than expected.

To submit a saved plan through the file command, use rad file --artifact plan.json. The plan must use the current format, and each source file must be tracked by Git.