How ivanpavlak/winux works
WinuX is a PowerShell dotfiles and Windows environment configurator. Its documented main flow is a user-triggered bootstrap that applies machine-aware configuration, provisions software and settings, and can be rerun for repair. Separate workflows manage repositories, application workspaces, window layouts, themes, WSL, and AI skills. The README documents these capabilities, but sampled source is limited to Firefox preferences and native window helpers, so links between runtime subsystems are conservative.
Main entry points: Resolve-BootstrapSteps.ps1 Bootstrap steps · Bootstrap.ps1 Bootstrap · Invoke-ObsidianWorkspaceLoad.ps1 Workspace loading · Install-WingetApps.ps1 Application installs
Components 19
Bootstrap and Configuration
- Bootstrap
Windows/PowerShell/Modules/Bootstrap/Functions/Bootstrap.ps1 - Configuration
Windows/PowerShell/Configuration.psd1 - Machine profiles
Windows/PowerShell/Modules/Bootstrap/Functions/DetermineMachineType.ps1 - Bootstrap steps
Windows/PowerShell/Modules/Bootstrap/Functions/Resolve-BootstrapSteps.ps1
System Provisioning
- Package managers
Windows/PowerShell/Modules/Bootstrap/Functions/Resolve-PackageManagers.ps1 - Application installs
Windows/PowerShell/Modules/Application/Functions/Install-WingetApps.ps1 - System settings
Windows/PowerShell/Modules/System - Dotfile links
Windows/PowerShell/Modules/Configuration/Functions/Add-SymbolicLink.ps1 - Repository updates
Windows/PowerShell/Modules/Git/Functions/Update-Repositories.ps1
Workflows and Applications
- Application launch
Windows/PowerShell/Modules/Application/Functions/Start-Application.ps1 - Project runner
Windows/PowerShell/Modules/Helper/Functions/Run-Project.ps1 - Workspace loading
Windows/PowerShell/Modules/Application/Functions/Invoke-ObsidianWorkspaceLoad.ps1 - Window management
Windows/PowerShell/Modules/Window/WindowNative.cs - System theming
Windows/PowerShell/Modules/System/Functions/Set-SystemTheme.ps1 - WSL setup
Windows/PowerShell/Modules/System/Functions/Configure-WSL.ps1
Integrations
- AI skill deployment
Windows/PowerShell/Modules/AI/Functions/Deploy-AiSkills.ps1
Other components
- WinuX user
- Windows
- Package sources
Connections 19
- WinuX user → Bootstrap: starts
- Bootstrap → Configuration: uses settings
- Bootstrap → Machine profiles: detects profile
- Bootstrap → Bootstrap steps: resolves steps
- Bootstrap steps → Package managers: selects managers
- Bootstrap steps → Application installs: provisions apps
- Bootstrap steps → System settings: applies settings
- Bootstrap steps → Dotfile links: links dotfiles
- Bootstrap steps → Repository updates: updates repos
- WinuX user → Project runner: runs projects
- WinuX user → Workspace loading: loads workspace
- Workspace loading → Application launch: opens applications
- Workspace loading → Window management: positions windows
- WinuX user → System theming: sets theme
- WinuX user → WSL setup: provisions WSL
- WinuX user → AI skill deployment: deploys skills
- System settings → Windows: configures
- Application installs → Package sources: installs from
- Repository updates → Package sources: clones or updates