🪟 Windows‑Specific Dotfiles
This branch (windows) contains only the configuration files and tools I use on Windows systems.
It is separated from the main branch to avoid mixing Linux/macOS configurations with those required only for Windows or WSL.
📦 Included Configurations
This branch includes:
- PowerShell and PowerShell Core profile settings (
Microsoft.PowerShell_profile.ps1) - Windows Terminal settings (
settings.json) - Neovim configuration (used via WSL or native Windows installation)
starship.tomlprompt configurationzsh/folder for WSL Zsh integration (if used)- Windows-specific
.gitconfigoverrides - Helper scripts (e.g.,
.ps1,.bat, or.shunder WSL) - Optional tools:
fzf,bat,zoxide,ripgrep,fd(via WSL or Windows-native)
🚀 Quick Setup
⚠️ This assumes Git, PowerShell 7+, and optionally Windows Terminal are installed.
Clone and install:
git clone https://github.com/fscotto/dotfiles -b windows $HOME\.dotfiles
cd $HOME\.dotfiles
.\bootstrap_windows.ps1
The script will:
- Copy or symlink PowerShell profile(s)
- Configure Windows Terminal settings
- Place
starship.tomlin the correct location - Set up additional tools if available
🧰 Optional Tools
Install these tools to get the best experience:
| Tool | Installation (native) | Usage |
|---|---|---|
starship |
winget install starship |
Prompt in PowerShell/Zsh |
zoxide |
winget install zoxide |
Smarter cd |
bat |
winget install bat |
Better cat |
fzf |
winget install fzf |
Fuzzy file finder |
fd |
winget install fd |
Fast file search |
ripgrep |
winget install ripgrep |
Recursive grep alternative |
You can also install these inside WSL with
aptorxbps-install, depending on the distro.
⚙️ Git Configuration
This branch includes Windows-specific Git settings (e.g. line endings, credential manager):
# .gitconfig.windows
[core]
autocrlf = true
[credential]
helper = manager-core
You can include this in your global config with:
git config --global include.path ~/.dotfiles/.gitconfig.windows
🖥️ Windows Terminal Settings
Settings are stored at:
%LOCALAPPDATA%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json
You can symlink or manually copy from this repo if needed.
🧭 Branch Structure
| Branch | Purpose | Content |
|---|---|---|
master |
Main configuration (Linux/macOS) | Shell, Neovim, Tmux, tools, etc. |
windows |
Windows-only configuration | PowerShell, Windows Terminal, WSL support |
📂 Directory Structure
dotfiles/
├── powershell/ # PowerShell profiles
├── windows-terminal/ # Windows Terminal settings
├── nvim/ # Neovim config (optional WSL sync)
├── starship.toml # Prompt config
├── bootstrap_windows.ps1 # Setup script
└── .gitconfig.windows # Git config overrides
🤝 Contributing
Found a useful Windows-only configuration or script?
Feel free to fork and open a pull request against the windows branch.
📝 License
MIT — Feel free to use, modify, and adapt.
Maintained by fscotto For Windows configuration only. See the
masterbranch for full cross-platform support.