This repository contains the scripts and configuration files I use to bootstrap a Windows workstation.
The setup installs a curated set of desktop tools, configures the Windows shell experience (PowerShell/WT), and keeps personal application settings versioned inside this repo.

• Windows 11 with administrative access.
• PowerShell 7+ (for modules like Install-Module, oh-my-posh, winget CLI, etc.).
• WinGet installed (included with modern Windows builds).

git clone https://github.com/SocketSomeone/dotfiles.git $env:USERPROFILE\dotfiles
cd $env:USERPROFILE\dotfiles
Set-ExecutionPolicy -Scope Process -ExecutionPolicy RemoteSigned
pwsh -File .\install\windows.ps1           # add -Debug to trace every step

What the installer does:

1. Imports helper modules from lib/windows.
2. Runs every script under packages/ (currently just the WinGet import) to ensure required software is present.
3. Executes all scripts under links/ to create symlinks for configuration files/directories and to install shell modules/fonts.

• Package list – Add/remove WinGet identifiers in packages/packages.json, then rerun the installer or invoke packages/winget.sync-packages.ps1 manually to apply the changes.
• PowerShell profile – Edit config/pwsh/Microsoft.PowerShell_profile.ps1 to tweak modules, PSReadLine bindings, or the oh-my-posh theme name stored in $THEME.
• Other apps – Adjust files under config/git, config/wt, config/wsl, or create new links/*.ps1 scripts if you want to manage more applications.

• The symlink helper prompts before overwriting existing files; rerun a specific script from links/ if you need to relink without running the full installer.
• Use the -Debug switch when launching install/windows.ps1 to see every command/path the bootstrapper touches.
• Because the repo stores plain text configuration, it's easy to track changes with Git across machines.

• Author - Alexey Filippov
• Twitter - @SocketSomeone

MIT © Alexey Filippov