Installation and prerequisites

Install the private-beta rad CLI on macOS or Linux and verify the downloaded archive before running it.

Onboard with a coding agent

Open your repository in a coding agent and paste this prompt:

Read https://docs.radforge.dev/quickstart.md, inspect this repository, and guide me through Radforge setup using its version-pinned installer. Start with a dry run. Ask before installing software, writing files, using credentials, or uploading source.

Before you begin

You need private-beta access to the Radforge release repository. During the private beta, the repository is not public. Run the installation commands while signed in to the GitHub account that Radforge granted access to. If you have not received access, request private-beta access.

Confirm that you have Git and a cloned Git repository. 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.
• Go 1.25.x or 1.26.x on Linux or macOS with amd64 or arm64, plus a root go.mod or go.work. See Go support for the complete compatibility and mutation-surface limits.
• Python with pytest, pyproject.toml, and uv.lock in the workspace Radforge will analyze.

Go, TypeScript/JavaScript, and Python support CLI planning, hosted execution, and GitHub pull-request analysis. One run targets one language.

Choose the archive for your system:

System	Archive
macOS on Apple silicon	radforge-darwin-arm64.tar.gz
macOS on Intel	radforge-darwin-amd64.tar.gz
Linux on ARM64	radforge-linux-arm64.tar.gz
Linux on x86-64	radforge-linux-amd64.tar.gz

Radforge does not provide a native Windows archive. Use a supported Linux environment approved by your organization.

Install with a coding agent

The coding agent can fetch and run the released installer without asking you to download or place archive files. Before it proceeds, the agent must explain that the command uses your authenticated GitHub CLI session to read the private release repository and ask for approval to use those credentials and install software.

After approval, check access with gh auth status, then run:

installer="$(mktemp)"
gh api \
  --method GET \
  -H "Accept: application/vnd.github.raw" \
  "repos/Radforge-Dev/radforge/contents/plugins/radforge/scripts/install-radforge.sh?ref=v0.1.0-rc.2" \
  > "$installer"
bash "$installer" --version v0.1.0-rc.2

The source path and release tag are both pinned to v0.1.0-rc.2. The installer detects macOS or Linux and amd64 or arm64, downloads the matching archive and checksum, verifies the checksum, installs rad under ~/.local/bin, and prints the installed version. If gh auth status fails or the release is inaccessible, the agent must stop and ask you to authenticate GitHub or obtain private-beta access. If ~/.local/bin is not on PATH, use "$HOME/.local/bin/rad" for the remaining commands.

Install on macOS

1. Download the archive and matching .sha256 file from the v0.1.0-rc.2 release.
2. From the download directory, verify the checksum:

shasum -a 256 -c radforge-darwin-arm64.tar.gz.sha256

3. Extract the archive and install rad:

tar -xzf radforge-darwin-arm64.tar.gz
mkdir -p "$HOME/.local/bin"
install -m 0755 radforge-darwin-arm64/rad "$HOME/.local/bin/rad"
rad --version

The final command prints radforge followed by the installed version. Replace arm64 with amd64 on an Intel Mac.

Install on Linux

1. Download the archive and matching .sha256 file from the v0.1.0-rc.2 release.
2. From the download directory, verify the checksum:

sha256sum -c radforge-linux-amd64.tar.gz.sha256

3. Extract the archive and install rad:

tar -xzf radforge-linux-amd64.tar.gz
mkdir -p "$HOME/.local/bin"
install -m 0755 radforge-linux-amd64/rad "$HOME/.local/bin/rad"
rad --version

The final command prints radforge followed by the installed version. Replace amd64 with arm64 on an ARM64 system.

Each release also includes an SPDX SBOM, SLSA provenance, and Sigstore bundles for release verification.

Optional coding-agent plugin

The Radforge source repository is also a private-beta plugin marketplace for Codex and Claude Code. Users need GitHub access to the repository.

For Codex, add the Git marketplace:

codex plugin marketplace add Radforge-Dev/radforge

For Claude Code, add the marketplace and install the plugin:

/plugin marketplace add Radforge-Dev/radforge
/plugin install radforge@radforge

The plugin provides setup and analyze skills. The setup skill uses the version-pinned, checksum-verifying installer included in the plugin and always previews repository initialization and remote verification before applying or uploading anything.

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.