A robust, portable, and aesthetically pleasing PowerShell profile configuration designed for seamless synchronization across devices.
- Portable Design: Works out-of-the-box on any machine, with or without OneDrive.
- Smart Session Detection: Optimized loading for VSCode, Standard Terminal, and Remote Sessions.
- Automated Setup: Single-script provisioning for new environments.
- Secure: Secrets are isolated and git-ignored by default.
- Beautiful: Pre-configured Oh My Posh themes and Terminal-Icons.
- Tooling: Includes
gitaliases, module management, and auto-updates.
For a fresh environment (VM, Laptop) where you want this specific setup:
-
Clone the repository:
git clone https://github.com/irmandos/windots.git "$HOME\Documents\PowerShell"
-
Run the Setup Script:
& "$HOME\Documents\PowerShell\setup.ps1"
This will install necessary apps (VSCode, Git, etc.), Nerd Fonts, and configure your profile.
If you already have your own dotfiles but want to use this profile:
- Clone to your profile directory.
- Rename
Microsoft.PowerShell_secrets.ps1.exampletoMicrosoft.PowerShell_secrets.ps1. - Add your API keys (Plex, OpenAI, etc.) to the secrets file.
| File | Description |
|---|---|
Microsoft.PowerShell_profile.ps1 |
Main Profile. Entry point that loads all other components. |
setup.ps1 |
Provisioner. Installs apps, fonts, and links the profile. |
module-manager.ps1 |
Handles module auto-installation and updates. |
aliases.ps1 |
Custom functions and aliases (Git, System, Navigation). |
oh-my-posh-theme.json |
Visual theme configuration. |
This repository is configured to ignore sensitive data.
- Secrets File:
Microsoft.PowerShell_secrets.ps1is ignored. Use the.examplefile as a template. - Custom Scripts: The
z.CustomScripts/folder (personal automation) is ignored. - Backups: Local
backup/folders are ignored.
- Theme: Modify
oh-my-posh-theme.jsonto change the prompt look. - VSCode: A specialized
oh-my-posh-vscode.json(if present) or optimized settings are loaded for VSCode terminals. - Modules: Add modules to
$script:RequiredModulesinmodule-manager.ps1to have them auto-installed.
Maintained by irmandos