Installation and prerequisites

Install the rad CLI on macOS or Linux. Release archives support Apple silicon/ARM64 and x86-64/AMD64. On Windows, use a supported Linux environment.

Before you install

Before installing Radforge, confirm that you have Git and a Git working tree. Your project must use one of these supported setups:

• TypeScript/JavaScript with Vitest and exactly one supported lockfile at the repository root: package-lock.json, pnpm-lock.yaml, bun.lock, or bun.lockb.
• Python with pytest, pyproject.toml, and uv.lock in the workspace Radforge will analyze.

Install the CLI

1. Download the archive and matching .sha256 file from Radforge releases.
2. Replace the archive name in the commands below with the file for your platform.
3. Verify the checksum, extract the archive, and place rad on your PATH.

shasum -a 256 -c radforge-darwin-arm64.tar.gz.sha256
tar -xzf radforge-darwin-arm64.tar.gz
install -m 0755 radforge-darwin-arm64/rad "$HOME/.local/bin/rad"
rad --version

The final command prints the installed version. Each release also includes an SBOM, build provenance, and a Sigstore bundle.

Set up a repository

Run rad init --dry-run in the repository, review the proposed changes, and apply them. Then run rad doctor to check the setup.