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).

⚠️ Safety. optimize is safe by default (-Profile safe) and never disables VSS/System Restore, StorSvc (Microsoft Store) or SmartScreen. To reverse any change, use -Group restore (see Troubleshooting).

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 -Profile safe  # safe optimizations (default)
.\setup.ps1 -Group restore -WhatIf              # preview undoing changes

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
• Services reference
• Restore (undo changes)
• Shell setup
• Customize
• Admin privileges
• Validation
• Beginner's guide
• Changelog

Contributing

Issues and pull requests are welcome — see CONTRIBUTING.md (gitflow, conventional commits). Report security issues privately via a security advisory (see SECURITY.md).

License

MIT — see LICENSE.