Skip to content
Forge

Install Forge

Forge is a Windows desktop app. macOS and Linux builds are on our roadmap. Until they ship, you’ll need a Windows 10 22H2 or Windows 11 machine.

Requirements

Section titled “Requirements”
  • Windows 10 22H2 or Windows 11
  • About 4 GB of free disk space (Forge plus the bundled Codex sidecar)
  • A ChatGPT account on a paid plan (Plus, Pro, or Team) for sign-in. The free tier works for read-only chats but most agent features need a paid tier.

Download

Section titled “Download”

Sign in to your Ranga account and grab the installer from the Downloads section:

ranga.ai/account

The build is gated to license holders during the alpha. If you don’t have a license yet, request one through the same page.

Install

Section titled “Install”

Run the MSI. Code signing is coming soon, so Windows SmartScreen will warn the first time you launch. Click More info, then Run anyway.

Forge installs to %ProgramFiles%\Forge\ and creates two folders for runtime state:

  • %APPDATA%\Forge\ holds the sessions database (forge.db) and Codex sidecar logs.
  • %USERPROFILE%\.forge\ holds skills, scratchpad memory, and your generated-asset cache.

Both folders survive uninstalls. To remove all state, delete them after uninstalling.

Confirm the sidecar

Section titled “Confirm the sidecar”

After Forge launches, look at the bottom-right of the Inspector. The status row should read:

codex     ● online
chatgpt   ○ signed out

The green dot on the codex row means the bundled OpenAI Codex binary started cleanly. If it sits at ○ starting… for more than ten seconds, see the Tauri command surface reference for the codex-sidecar log path you can inspect.

Next

Section titled “Next”