A PowerShell profile made to make a CLI nerd's life easier. Brings the Linux terminal experience to Windows - grep, cat, ls with icons, fuzzy search, zoxide, and 60+ utility commands out of the box. One command installs everything and keeps it updated. Works on both PowerShell 5.1 and 7+.

Why use this?

• One command, fully configured - installs 6 tools, Nerd Fonts, Oh My Posh theme, and Windows Terminal settings in one run
• Self-updating - profile, theme, and terminal config sync from upstream with hash verification
• AI/CI sandbox safe - detects non-interactive environments and suppresses network calls and UI setup automatically
• PS5 + PS7 - installs to both profile directories and handles every API difference between editions
• Hardened - sensitive commands filtered from PSReadLine history; no secrets in source
• Fast startup - prompt renders directly from a local Oh My Posh theme; only zoxide init is cached
• Survives updates - personal overrides in profile_user.ps1 and user-settings.json are never touched

Originally forked and inspired by ChrisTitusTech/powershell-profile.

Run in an elevated PowerShell window:

irm "https://github.com/26zl/PowerShellPerfect/raw/main/setup.ps1" | iex

The terminal restarts automatically when setup finishes (new tab in Windows Terminal, or new window otherwise). For the best experience use PowerShell 7.

Recommended for Oh My Posh: Install the x64 MSI from the releases page (see Oh My Posh) instead of winget/Store—this profile preserves a direct install and avoids the WindowsApps path. If you already have the MSI install, setup leaves it as is.

git clone https://github.com/26zl/PowerShellPerfect.git
cd PowerShellPerfect
.\setup.ps1
.\setprofile.ps1

When running locally you can override terminal defaults (not available via irm | iex):

.\setup.ps1 -Opacity 85 -ColorScheme "One Half Dark" -FontSize 12

Controlled Folder Access: If Windows Defender blocks the setup, allow PowerShell through:

Add-MpPreference -ControlledFolderAccessAllowedApplications "C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe"
Add-MpPreference -ControlledFolderAccessAllowedApplications "C:\Program Files\PowerShell\7\pwsh.exe"

Update-Profile      # Sync profile, theme, caches, and Windows Terminal settings
Update-PowerShell   # Check for new PowerShell 7 releases
Update-Tools        # Update winget-managed tools; direct/MSI Oh My Posh installs are preserved

Update-Profile requires hash verification by default. Confirm with -ExpectedSha256 '<hash>', or use -SkipHashCheck to bypass. Use -Force to re-apply settings even when nothing changed upstream.

Remove the profile, caches, and Windows Terminal changes:

Uninstall-Profile              # Core cleanup: profile files, caches, WT restore, PSFzf
Uninstall-Profile -RemoveTools # Also uninstall managed CLI tools (including direct/MSI Oh My Posh when detected)
Uninstall-Profile -All         # Remove everything including tools, fonts, and user data
Uninstall-Profile -All -HardResetWindowsTerminal # Same as -All, but also delete WT settings.json so WT recreates factory defaults

Optional switches: -RemoveTools (winget-managed tools plus direct/MSI Oh My Posh when registered as MSI), -RemoveUserData (profile_user.ps1, user-settings.json), -RemoveFonts (Nerd Fonts, requires admin), -All (everything), -HardResetWindowsTerminal (delete WT settings.json and backups so Windows Terminal recreates defaults). Supports -WhatIf to preview without making changes.

Two files survive updates and override everything:

• profile_user.ps1 (Split-Path $PROFILE) - PowerShell overrides: aliases, functions, editor, colors, modules
• user-settings.json (%LOCALAPPDATA%\PowerShellProfile\) - Terminal overrides: theme, opacity, font, keybindings

Both are created automatically during setup. profile_user.ps1 is dot-sourced last so your settings always win.

Run Show-Help in your terminal for a colored version of this list.