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
- Extract the provided ForgeAI package to a local folder.
- Run the included installer script from a PowerShell prompt.
- Accept or customize the recommended installation path when prompted.
- 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.