rad remote commands

Use rad remote to submit and manage hosted mutation runs.

Submit a run

Create a plan, verify hosted access, and submit the plan:

rad plan --target src/example.ts --json > plan.json
rad remote doctor
rad remote run --artifact plan.json

remote run uploads the JSON plan and a compressed snapshot of regular files tracked by Git. The snapshot includes tracked files with local changes. It excludes untracked files, symlinks, special files, and paths outside the repository. Radforge rejects a plan that names an untracked source file.

Check a run

rad remote status --run run-id
rad remote findings --run run-id

Cancel an attempt

Provide a reason when you cancel the active attempt:

rad remote cancel --run run-id --attempt attempt-id --reason "Superseded by a new commit"

The reason must be one line and at most 512 characters after surrounding whitespace is removed. If the attempt has already finished, cancellation reports that it made no change.

Retry a run

Retry a completed, failed, or canceled run with the same plan and source snapshot:

rad remote retry --run run-id

The server decides whether a run can be retried. A retry creates a new attempt but does not upload your current working tree. If the code or plan changed, generate and submit a new plan.