Groups Reference

Groups Reference

winforge organizes work into 7 modular groups. Each group installs programs, applies configuration, or both. Run one with -Group <name> or all by omitting the flag.

Group	Purpose	Contents
base	Essential programs	Firefox, Git, VLC, WinRAR, LibreOffice (5)
dev	Development tools	VS Code, GitHub Desktop, Claude, Python (4)
gaming	Gaming & social	Steam, Discord (2)
system	System utilities	NVIDIA App, AMD Radeon, CPU-Z, HWMonitor (4)
optimize	System tuning	42+ tweaks — services, power, network, storage, visual
customize	UI customization	18 Windows Explorer / shell tweaks
shell	Terminal enhancement	Oh My Posh (half-life theme) + Fira Code

Program groups (base / dev / gaming / system)

These install applications through the fallback chain (Winget → Chocolatey → custom URL). Detection is idempotent: already-installed apps are skipped.

Configuration groups (optimize / customize / shell)

These apply registry, service, and profile changes rather than installing apps:

• optimize — performance and service tuning for a desktop that stays on. See Optimization Details.
• customize — File Explorer, taskbar, Start menu, dark mode, mouse/keyboard tweaks. See docs/CUSTOMIZE.md.
• shell — PowerShell profile, Oh My Posh, Fira Code, PSReadLine, aliases. See Shell Enhancement.

Adding your own programs

Edit the relevant module in src/modules/ and add an entry to its $programs array:

@{
    Name       = "My App"
    WingetId   = "Publisher.MyApp"
    ChocoId    = "myapp"        # optional Chocolatey fallback
    Executable = "myapp"        # optional, used for detection
}

Then validate detection without installing:

.\tools\validate.ps1 -Group <group> -ShowDetails