Home

winforge

Automate Windows post-format setup & system optimization.

winforge is a modular PowerShell 7+ framework for configuring Windows after a clean install: program installation (15 apps across 7 groups), system optimization (42+ registry/service tweaks), UI customization, and shell enhancement with Oh My Posh. It uses smart idempotent detection and a multi-method install fallback (Winget → Chocolatey → custom URL).

Quick start

git clone https://github.com/gsjonio/winforge.git
cd winforge
sudo .\setup.ps1

Or run a single group:

sudo .\setup.ps1 -Group shell      # just shell enhancement
sudo .\setup.ps1 -Group optimize   # just system optimizations

See Installation for prerequisites and details.

Wiki pages

• Installation — prerequisites, quick start, running by group
• Groups Reference — what each of the 7 groups installs or changes
• Optimization Details — the 42+ system tweaks explained
• Shell Enhancement — Oh My Posh, Fira Code, PSReadLine, aliases
• Troubleshooting — admin/UAC, execution policy, winget, common errors

In-repo documentation

For the deepest reference, see the docs in the repository:

• Architecture
• Optimize details
• Shell setup
• Customize
• Admin privileges
• Validation
• Changelog

License

MIT — see LICENSE.