Install Guide

Windows Installation Guide

ForgeAI Level 0 is production validated on Windows. macOS and Linux are planned and not currently supported.

1. Access

The Windows package is currently distributed to approved early-access participants rather than as a public self-serve download. Request early access to receive installation instructions and the package for your account.

2. Requirements

  • Windows 10 or later
  • Node.js 24.18.0 or later (below 25.0.0)

3. Installation steps

  1. Extract the provided ForgeAI package to a local folder.
  2. Run the included installer script from a PowerShell prompt.
  3. Accept or customize the recommended installation path when prompted.
  4. The installer verifies package integrity (checksums) before completing installation.

4. First launch

After installation, open a new terminal so the forge command is available, then run:

forge help

5. Version and help

forge version

6. Doctor (environment check)

Run this after installation, and any time something looks wrong, to check your local environment and repository:

forge doctor

7. Basic repository usage

Analyze a repository (read-only):

forge analyze .

Submit a planning-only request:

forge run "add a health endpoint" .

Execution against a repository requires explicit approval and authorization, as described on our Security page.

8. Uninstall

Run the uninstall script included in your installation folder (Uninstall-ForgeAI.ps1) to remove ForgeAI from your machine.

9. Troubleshooting and support

Start with forge doctor to diagnose common environment issues. If you remain stuck, reach out through our contact page.