PowerShell profile and test suite

Matthew created a production-ready PowerShell prompt that supports PS 5.1 and PS 7+ with segments for Git, Python venv, Conda, Node, .NET SDK, exit code, jobs, admin, Kubernetes, Azure/AWS/GCP, depth, path, and timestamp. The prompt uses a Campbell palette with 24-bit ANSI for PS7 and ConsoleColor fallback for PS5, and includes environment capability probing to adapt to constrained language mode, non-interactive hosts, and ANSI support.

| Requires -Version 5.1 | | ============================================================================= | | Matthew's Production-Ready PowerShell Prompt | | Supports: PS 5.1 Windows PowerShell and PS 7+ PowerShell Core | | Segments: Git · Python venv · Conda · Node · .NET SDK · Exit code · | | Jobs · Admin · Kubernetes · Azure/AWS/GCP · Depth · Path · | | Timestamp | | Palette: Campbell PS7 24-bit ANSI / Campbell PS5 ConsoleColor fallback | | ============================================================================= | | | | ── Version detection ──────────────────────────────────────────────────────── | | $script:PS7 = $PSVersionTable.PSVersion.Major -ge 7 | | | | ============================================================================= | | SECTION 0 – ENVIRONMENT CAPABILITY PROBE run ONCE at load | | The prompt renders only what the current host supports and skips work that | | isn't relevant, so it stays correct AND fast in every environment: a full | | ANSI console, a legacy/redirected host, a non-interactive script host, a | | remoting/embedded host, or a Constrained-Language WDAC/AppLocker session. | | Every probe is wrapped so a host that doesn't implement it can't break load. | | ============================================================================= | | | | Constrained Language Mode blocks .NET method/ctor/type calls that the rich | | segments rely on; detect it so we serve a minimal, CLM-safe prompt instead. | | $script:ConstrainedLang = $false | | try { $script:ConstrainedLang = $ExecutionContext.SessionState.LanguageMode -ne 'FullLanguage' } catch { } | | | | Interactive session? Only these benefit from PSReadLine. Default to $true and | | narrow ONLY on a strong non-interactive signal a service context, or an | | explicit -NonInteractive , so we never strip history search from a real | | interactive host — note embedded consoles e.g. the VS Code PowerShell | | Extension launch via -Command yet ARE interactive, so -Command is NOT a signal. | | $script:IsInteractive = $true | | try { | | if -not Environment ::UserInteractive { $script:IsInteractive = $false } | | elseif Environment ::GetCommandLineArgs -match '^-NonInteractive' { $script:IsInteractive = $false } | | } catch { } | | | | ANSI / virtual-terminal support → the coloured ANSI render path vs the plain | | ConsoleColor Write-Host path. PS7 in any modern terminal supports VT; a host | | that doesn't or lacks the property falls back to ConsoleColor output. | | $script:SupportsAnsi = $false | | try { $script:SupportsAnsi = $script:PS7 -and bool $Host.UI.SupportsVirtualTerminal } catch { } | | | | Settable window title? Some remoting/embedded hosts have a null RawUI or throw. | | $script:SupportsTitle = $false | | try { $null = $Host.UI.RawUI.WindowTitle; $script:SupportsTitle = $true } catch { } | | | | ============================================================================= | | SECTION 1 – COLOR PALETTE | | Campbell palette values match Windows Terminal's built-in Campbell theme. | | ANSI-capable host → 24-bit ANSI escape sequences ESC 38;2;R;G;Bm | | Otherwise → Write-Host -ForegroundColor nearest ConsoleColor | | ============================================================================= | | | | if $script:SupportsAnsi { | | ── Campbell 24-bit ANSI sequences ─────────────────────────────────────── | | $E = char 27 ESC character | | | | Foreground helpers returns an ANSI escape string | | function script:Fg { param int $R, int $G, int $B "$E 38;2;$R;$G;${B}m" } | | function script:Bg { param int $R, int $G, int $B "$E 48;2;$R;$G;${B}m" } | | $script:Reset = "$E 0m" | | $script:Bold = "$E 1m" | | $script:Dim = "$E 2m" | | | | Campbell named colours | | $script:CBlack = Fg 12 12 12 Black | | $script:CRed = Fg 197 15 31 Red | | $script:CGreen = Fg 19 161 14 Green | | $script:CYellow = Fg 193 156 0 Yellow | | $script:CBlue = Fg 0 55 218 Blue | | $script:CMagenta = Fg 136 0 128 Magenta | | $script:CCyan = Fg 58 150 221 Cyan | | $script:CWhite = Fg 204 204 204 White light gray | | $script:CBrBlack = Fg 118 118 118 Bright Black dark gray | | $script:CBrRed = Fg 231 72 86 Bright Red | | $script:CBrGreen = Fg 22 198 12 Bright Green | | $script:CBrYellow= Fg 249 241 165 Bright Yellow | | $script:CBrBlue = Fg 59 120 255 Bright Blue | | $script:CBrMag = Fg 180 0 158 Bright Magenta | | $script:CBrCyan = Fg 97 214 214 Bright Cyan | | $script:CBrWhite = Fg 242 242 242 Bright White | | | | Semantic aliases | | $script:ColPath = $script:CBrCyan | | $script:ColGitBranch= $script:CBrMag | | $script:ColGitDirty = $script:CBrRed | | $script:ColGitClean = $script:CBrGreen | | $script:ColGitInfo = $script:CYellow | | $script:ColPython = $script:CBrYellow | | $script:ColConda = $script:CYellow | | $script:ColNode = $script:CGreen | | $script:ColDotNet = $script:CBrBlue | | $script:ColErrCode = $script:CBrRed | | $script:ColOK = $script:CBrGreen | | $script:ColAdmin = $script:CBrRed | | $script:ColJobs = $script:CCyan | | $script:ColK8s = $script:CBrBlue | | $script:ColCloud = $script:CBrCyan | | $script:ColDepth = $script:CBrBlack | | $script:ColTime = $script:CBrBlack | | $script:ColSep = $script:CBrBlack | | $script:ColPromptOK = $script:CBrGreen | | $script:ColPromptErr= $script:CBrRed | | | | Render a styled string PS7 path – ANSI | | function script:Styled { | | param string $Color, string $Text, switch $Bold | | if $Bold { return "$script:Bold$Color$Text$script:Reset" } | | return "$Color$Text$script:Reset" | | } | | | | } else { | | ── Campbell PS5 ConsoleColor fallback ──────────────────────────────────── | | No ANSI; we build the prompt as an array of Write-Host calls instead. | | Prompt function writes each segment, then returns an empty string. | | | | $script:ColPath = 'Cyan' | | $script:ColGitBranch = 'Magenta' | | $script:ColGitDirty = 'Red' | | $script:ColGitClean = 'Green' | | $script:ColGitInfo = 'Yellow' | | $script:ColPython = 'Yellow' | | $script:ColConda = 'Yellow' | | $script:ColNode = 'Green' | | $script:ColDotNet = 'Blue' | | $script:ColErrCode = 'Red' | | $script:ColOK = 'Green' | | $script:ColAdmin = 'Red' | | $script:ColJobs = 'Cyan' | | $script:ColK8s = 'Blue' | | $script:ColCloud = 'Cyan' | | $script:ColDepth = 'DarkGray' | | $script:ColTime = 'DarkGray' | | $script:ColSep = 'DarkGray' | | $script:ColPromptOK = 'Green' | | $script:ColPromptErr = 'Red' | | | | In PS5 mode the prompt pieces are accumulated for Write-Host | | $script:PromptPieces = System.Collections.Generic.List hashtable ::new | | | | function script:Styled { | | param string $Color, string $Text, switch $Bold | | Returns nothing; accumulates into PromptPieces for later Write-Host | | $null = $script:PromptPieces.Add @{ Color = $Color; Text = $Text } | | return '' | | } | | } | | | | ============================================================================= | | SECTION 2 – UTILITY HELPERS | | ============================================================================= | | | | Separator character no Nerd Fonts dependency; swap to or if you have NF | | $script:Sep = '|' | | | | How to compare a path against $HOME for the '~' collapse. Windows paths are | | case-insensitive C:\ vs c:\, USERS vs Users , so an Ordinal compare can miss | | the home prefix and leave the path un-collapsed; Linux/macOS file systems | | PS7 only ARE case-sensitive, so stay Ordinal there. $IsWindows is only | | evaluated on PS7 the -and short-circuits on 5.1, where it doesn't exist . | | $script:PathComparison = System.StringComparison ::OrdinalIgnoreCase | | if $script:PS7 -and -not $IsWindows { | | $script:PathComparison = System.StringComparison ::Ordinal | | } | | | | Add a segment string to the prompt line ANSI returns inline; ConsoleColor queues | | function script:Seg { | | param string $Color, string $Text | | if $script:SupportsAnsi { | | return "$ Styled $Color "$Text" $ Styled $script:ColSep $script:Sep " | | } else { | | $null = $script:PromptPieces.Add @{ Color = $Color; Text = "$Text" } | | $null = $script:PromptPieces.Add @{ Color = $script:ColSep; Text = $script:Sep } | | return '' | | } | | } | | | | Safe command existence check avoids exceptions , cached per session. | | Use -ErrorAction Ignore, not SilentlyContinue: SilentlyContinue hides the | | error but STILL appends it to $Error, so every prompt render would leave | | "<cmd is not recognized" noise for each missing CLI aws, gcloud, ... . | | Caching spares a Get-Command discovery for every CLI on every render; CLI | | availability effectively never changes mid-session restart to re-probe . | | $script:CmdCache = @{} | | Per-directory caches cwd - @{ Ver=<string|$null ; Exp=<datetime } for the | | project-aware Node/.NET segments, so their directory walk + the slow node / | | dotnet --version spawn run at most once per 30 s per directory cf. K8s . | | $script:NodeCache = @{} | | $script:DotNetCache = @{} | | function script:CommandExists { | | param string $cmd | | if -not $script:CmdCache.ContainsKey $cmd { | | $script:CmdCache $cmd = bool Get-Command $cmd -ErrorAction Ignore | | } | | return $script:CmdCache $cmd | | } | | | | Truncate a path to at most $MaxDepth leaf components | | function script:TruncatePath { | | param string $FullPath, int $MaxDepth = 4 | | $home path = $HOME -replace '\\','/' | | $display = $FullPath -replace '\\','/' | | Guard the empty/unset $HOME case rare SYSTEM/service contexts : ''.StartsWith '' | | is always true, which would prepend a bogus '~' to every path. | | if $home path -and $display.StartsWith $home path, $script:PathComparison { | | $display = '~' + $display.Substring $home path.Length | | } | | $parts = $display.TrimStart '/' .Split '/' | | if $display.StartsWith '~' { | | Substring 2 throws when $display is exactly '~' home dir, length 1 , | | so only strip the '~/' prefix when there is something after it. | | $rest = if $display.Length -gt 2 { $display.Substring 2 } else { '' } | | $parts = @ '~' + $rest.Split '/' | Where-Object { $ } | | } | | $depth = $parts.Count | | if $depth -le $MaxDepth { return $display, $depth } | | Use the -join operator, not Join-String: Join-String is a PS7 cmdlet that | | does NOT exist in Windows PowerShell 5.1, so any path deeper than $MaxDepth | | would throw here and the prompt would fall back to the bare "PS " default. | | $tail = $parts | Select-Object -Last $MaxDepth - 1 | | $truncated = '…/' + $tail -join '/' | | return $truncated, $depth | | } | | | | ============================================================================= | | SECTION 3 – PROMPT SEGMENTS | | ============================================================================= | | | | ── 3.1 Admin / Elevated ──────────────────────────────────────────────────── | | function script:Get-AdminSegment { | | $isAdmin = $false | | if $script:PS7 -and $IsLinux { | | $isAdmin = id -u -eq '0' | | } else { | | $principal = Security.Principal.WindowsPrincipal Security.Principal.WindowsIdentity ::GetCurrent | | $isAdmin = $principal.IsInRole Security.Principal.WindowsBuiltInRole ::Administrator | | } | | if $isAdmin { return Seg $script:ColAdmin '⚡ADMIN' } | | return '' | | } | | | | ── 3.2 Exit-code indicator ───────────────────────────────────────────────── | | function script:Get-ExitCodeSegment { | | param int $LastExit | | if $LastExit -ne 0 { | | return Seg $script:ColErrCode "✘ $LastExit" | | } | | return '' | | } | | | | ── 3.3 Background jobs ───────────────────────────────────────────────────── | | function script:Get-JobsSegment { | | $jobs = @ Get-Job -ErrorAction SilentlyContinue | Where-Object { $ .State -ne 'Completed' -and $ .State -ne 'Failed' } | | if $jobs.Count -gt 0 { | | return Seg $script:ColJobs "⚙ $ $jobs.Count " | | } | | return '' | | } | | | | ── 3.4 Directory path + depth ────────────────────────────────────────────── | | function script:Get-PathSegment { | | $raw = $PWD.ProviderPath | | $display, $depth = TruncatePath $raw 4 | | | | Depth indicator: show only when 3 directories deep | | $depthStr = '' | | if $depth -gt 3 { | | if $script:SupportsAnsi { $depthStr = "$ Styled $script:ColDepth " $depth " " } | | else { | | $null = $script:PromptPieces.Add @{ Color = $script:ColDepth; Text = " $depth " } | | } | | } | | | | $pathStr = Seg $script:ColPath $display | | if $script:SupportsAnsi { return "$depthStr$pathStr" } | | return '' | | } | | | | ── 3.5 Git segment ───────────────────────────────────────────────────────── | | Git stash ≡N / worktree ⎇N indicators each cost an extra git spawn, so | | they're OFF by default keeps the segment to a single git status . Toggle for | | the session with Enable-GitExtras / Disable-GitExtras, or flip this to $true to | | default them on. | | $script:GitShowExtras = $false | | | | function script:Get-GitSegment { | | if -not CommandExists 'git' { return '' } | | | | ONE spawn for branch, upstream ahead/behind AND per-file status. Porcelain | | v2 --branch replaces the old rev-parse + symbolic-ref + status + rev-list | | 4 git processes collapsed to 1 . git status exits non-zero outside a | | repo, which doubles as the in-repo check. | | $statusOut = git status --porcelain=v2 --branch 2 $null | | if $LASTEXITCODE -ne 0 { return '' } | | | | $branch = ''; $oid = ''; $ahead = 0; $behind = 0 | | $xy = System.Collections.Generic.List string ::new | | foreach $line in $statusOut { | | if -not $line { continue } | | $c = $line 0 | | if $c -eq ' ' { | | if $line.StartsWith ' branch.head ' { $branch = $line.Substring 14 } | | elseif $line.StartsWith ' branch.oid ' { $oid = $line.Substring 13 } | | elseif $line.StartsWith ' branch.ab ' -and $line -match '\+ \d+ \s+- \d+ ' { | | $ahead = int $Matches 1 ; $behind = int $Matches 2 | | } | | } | | Changed/renamed entries carry a 2-char <xy ; porcelain v2 writes '.' where | | v1 used a space, so map it back and reuse the original v1 status regexes. | | elseif $c -eq '1' -or $c -eq '2' -and $line.Length -ge 4 { $xy.Add $line.Substring 2,2 -replace '\.',' ' } | | elseif $c -eq 'u' -and $line.Length -ge 4 { $xy.Add $line.Substring 2,2 } unmerged | | elseif $c -eq '?' { $xy.Add '??' } untracked | | } | | | | Detached HEAD: branch.head is " detached "; show the short OID like before. | | if $branch -eq ' detached ' { | | $branch = if $oid.Length -ge 7 { "➦ $ $oid.Substring 0,7 " } else { '➦ ?' } | | } | | | | Same semantics as the old v1 parse the @ ... keeps .Count defined for a | | single scalar match / an empty AutomationNull result . | | $dirty = @ $xy | Where-Object { $ -match '^ MADRCU? MADRCU? ' } .Count -gt 0 | | $staged = @ $xy | Where-Object { $ -match '^ MADRCU ' } .Count -gt 0 | | | | Stash + worktree each need their OWN git process, so they're gated behind | | the default-off $script:GitShowExtras toggle Enable-GitExtras . With it off | | the segment makes a single git status spawn. | | $stashCount = 0 | | $worktreeStr = '' | | if $script:GitShowExtras { | | $stashCount = git stash list 2 $null | Measure-Object .Count | | $worktreeCount = git worktree list --porcelain 2 $null | Where-Object { $ -match '^worktree ' } | Measure-Object .Count | | if $worktreeCount -gt 1 { $worktreeStr = " ⎇$worktreeCount" } | | } | | | | $branchColor = if $dirty -or $staged { $script:ColGitDirty } else { $script:ColGitClean } | | $gitStr = "$branch$worktreeStr" | | | | $suffix = '' | | if $staged { $suffix += ' ●' } staged changes | | if $dirty { $suffix += ' ✚' } unstaged changes | | if $ahead -gt 0 { $suffix += " ↑$ahead" } ahead of remote | | if $behind -gt 0 { $suffix += " ↓$behind" } behind remote | | if $stashCount -gt 0 { $suffix += " ≡$stashCount" } stashes | | | | return Seg $branchColor "$gitStr$suffix" | | } | | | | ── 3.6 Python virtual environment ────────────────────────────────────────── | | function script:Get-PythonVenvSegment { | | $venv = $env:VIRTUAL ENV | | if -not $venv { return '' } | | $venvName = Split-Path $venv -Leaf | | return Seg $script:ColPython "🐍 $venvName" | | } | | | | ── 3.7 Conda environment ─────────────────────────────────────────────────── | | function script:Get-CondaSegment { | | $condaEnv = $env:CONDA DEFAULT ENV | | if -not $condaEnv -or $condaEnv -eq 'base' { return '' } | | return Seg $script:ColConda "🅒 $condaEnv" | | } | | | | ── 3.8 Node version project-aware: .nvmrc / .node-version / package.json ─ | | function script:Get-NodeSegment { | | if -not CommandExists 'node' { return '' } | | Cache the resolved version per directory for 30 s raw value, not the Seg | | result, so the ConsoleColor path still queues its piece every render . | | $cwd = $PWD.ProviderPath | | $now = datetime ::UtcNow | | $entry = $script:NodeCache $cwd | | if -not $entry -or $now -ge $entry.Exp { | | $entry = @{ Ver = Find-NodeVersion $cwd ; Exp = $now.AddSeconds 30 } | | $script:NodeCache $cwd = $entry | | } | | if $entry.Ver { return Seg $script:ColNode "⬡ $ $entry.Ver " } | | return '' | | } | | | | Walk up from $startDir; on the first Node project marker return node --version . | | function script:Find-NodeVersion { | | param string $startDir | | $markers = @ 'package.json','.nvmrc','.node-version' | | $check = $startDir | | while $check -and $check -ne Split-Path $check -Parent { | | foreach $m in $markers { | | if Test-Path Join-Path $check $m { | | $v = node --version 2 $null | | return $ if $v { "$v" } else { $null } | | } | | } | | $check = Split-Path $check -Parent | | } | | return $null | | } | | | | ── 3.9 .NET SDK version project-aware: .csproj / .sln / global.json ─── | | function script:Get-DotNetSegment { | | if -not CommandExists 'dotnet' { return '' } | | Cache the resolved SDK version per directory for 30 s raw value, not the | | Seg result . This kills both the per-render marker walk AND the slow | | dotnet --version spawn in the steady state. | | $cwd = $PWD.ProviderPath | | $now = datetime ::UtcNow | | $entry = $script:DotNetCache $cwd | | if -not $entry -or $now -ge $entry.Exp { | | $entry = @{ Ver = Find-DotNetVersion $cwd ; Exp = $now.AddSeconds 30 } | | $script:DotNetCache $cwd = $entry | | } | | if $entry.Ver { return Seg $script:ColDotNet ".NET $ $entry.Ver " } | | return '' | | } | | | | Walk up from $startDir; on the first .NET marker global.json or a project/sln | | file return dotnet --version . One Test-Path + one -Include Get-ChildItem per | | level vs the old five -Filter calls ; the result is cached by the caller. | | function script:Find-DotNetVersion { | | param string $startDir | | $check = $startDir | | while $check -and $check -ne Split-Path $check -Parent { | | if Test-Path Join-Path $check 'global.json' -or | | Get-ChildItem -Path Join-Path $check ' ' -Include ' .csproj',' .fsproj',' .vbproj',' .sln' -File -ErrorAction Ignore | Select-Object -First 1 { | | $v = dotnet --version 2 $null | | return $ if $v { "$v" } else { $null } | | } | | $check = Split-Path $check -Parent | | } | | return $null | | } | | | | ── 3.10 Kubernetes context ────────────────────────────────────────────────── | | function script:Get-K8sSegment { | | if -not CommandExists 'kubectl' { return '' } | | | | Avoid spawning kubectl every keystroke – refresh the raw context/namespace | | at most every 30 s. NB: cache the RAW values, not the Seg result. In PS5, | | Seg has a side effect it queues a Write-Host piece and returns ''; caching | | that '' and short-circuiting would drop the segment from the PS5 prompt on | | every cached render. Calling Seg each render keeps PS5 correct while still | | throttling the kubectl spawns. | | $now = datetime ::UtcNow | | if -not $script:K8sCacheExpiry -or $now -ge $script:K8sCacheExpiry { | | $script:K8sCtx = kubectl config current-context 2 $null | | $script:K8sNs = kubectl config view --minify --output 'jsonpath={..namespace}' 2 $null | | $script:K8sCacheExpiry = $now.AddSeconds 30 | | } | | | | if $script:K8sCtx { | | $nsStr = if $script:K8sNs -and $script:K8sNs -ne 'default' { ":$ $script:K8sNs " } else { '' } | | return Seg $script:ColK8s "☸ $ $script:K8sCtx $nsStr" | | } | | return '' | | } | | | | ── 3.11 Cloud CLI context ─────────────────────────────────────────────────── | | function script:Get-CloudSegment { | | $parts = System.Collections.Generic.List string ::new | | | | Azure CLI az account show is slow; read cached JSON instead | | if CommandExists 'az' { | | IO.Path ::Combine, not 3-arg Join-Path: the 3+ argument form of | | Join-Path is PS7-only and throws on Windows PowerShell 5.1. | | $azProfile = IO.Path ::Combine $HOME, '.azure', 'azureProfile.json' | | if Test-Path $azProfile { | | try { | | $azData = Get-Content $azProfile -Raw | ConvertFrom-Json | | $sub = $azData.subscriptions | Where-Object { $ .isDefault } | Select-Object -First 1 | | if $sub { $parts.Add "☁ az:$ $sub.name " } | | } catch { } | | } | | } | | | | AWS CLI reads env var; falls back to ~/.aws/config active profile | | if CommandExists 'aws' { | | $awsProfile = $env:AWS PROFILE | | if -not $awsProfile { $awsProfile = $env:AWS DEFAULT PROFILE } | | if -not $awsProfile { $awsProfile = 'default' } | | if $awsProfile -ne 'default' { $parts.Add "aws:$awsProfile" } | | } | | | | GCP / gcloud reads active config; caches the slow gcloud spawn | | if CommandExists 'gcloud' { | | IO.Path ::Combine, not 4-arg Join-Path PS7-only; throws on PS 5.1 . | | $gcpConfig = IO.Path ::Combine $HOME, '.config', 'gcloud', 'active config' | | if Test-Path $gcpConfig { | | $cfg = Get-Content $gcpConfig -ErrorAction SilentlyContinue .Trim | | if $cfg { | | gcloud config get-value shells out to Python ~0.5–1 s , so it ran | | on EVERY prompt render. Cache the resolved project for 30 s, and | | re-query immediately when the active config name changes e.g. | | gcloud config configurations activate <name . | | $now = datetime ::UtcNow | | if $script:GcpProjConfig -ne $cfg -or -not $script:GcpProjExpiry -or $now -ge $script:GcpProjExpiry { | | $script:GcpProj = gcloud config get-value project 2 $null | | $script:GcpProjConfig = $cfg | | $script:GcpProjExpiry = $now.AddSeconds 30 | | } | | if $script:GcpProj { $parts.Add "gcp:$ $script:GcpProj " } else { $parts.Add "gcp:$cfg" } | | } | | } | | } | | | | if $parts.Count -eq 0 { return '' } | | return Seg $script:ColCloud $parts -join ' ' | | } | | | | ── 3.12 Timestamp ─────────────────────────────────────────────────────────── | | function script:Get-TimeSegment { | | return Seg $script:ColTime Get-Date -Format 'HH:mm:ss' | | } | | | | ============================================================================= | | SECTION 4 – PROMPT FUNCTION | | ============================================================================= | | | | ── Rich prompt: full language, all segments. The dispatcher passes in the | | captured $LASTEXITCODE and restores it afterwards. | | function script:Get-RichPrompt { | | param $RealLastExit | | $RealLastExit is the live $LASTEXITCODE captured by the dispatcher which | | restores it afterwards . Normalise $null → 0 so a fresh session | | $LASTEXITCODE = $null isn't treated as a failure by the glyph / exit segment. | | $lastExit = if $null -ne $RealLastExit { $RealLastExit } else { 0 } | | | | if -not $script:SupportsAnsi { | | ConsoleColor path: reset the Write-Host piece list each invocation. | | $script:PromptPieces = System.Collections.Generic.List hashtable ::new | | } | | | | ── Assemble all segments ──────────────────────────────────────────────── | | $line1 = '' | | | | Left side of line 1: Admin · Exit · Jobs · Path · Git · Envs · Tools · Cloud · K8s | | $line1 += Get-AdminSegment | | $line1 += Get-ExitCodeSegment -LastExit $lastExit | | $line1 += Get-JobsSegment | | $line1 += Get-PathSegment | | $line1 += Get-GitSegment | | $line1 += Get-PythonVenvSegment | | $line1 += Get-CondaSegment | | $line1 += Get-NodeSegment | | $line1 += Get-DotNetSegment | | $line1 += Get-CloudSegment | | $line1 += Get-K8sSegment | | $line1 += Get-TimeSegment | | | | ── Prompt glyph on line 2 ─────────────────────────────────────────────── | | $glyphColor = if $lastExit -eq 0 { $script:ColPromptOK } else { $script:ColPromptErr } | | $nestedDepth = $NestedPromptLevel | | $glyph = '❯' Math ::Max 1, $nestedDepth + 1 | | | | Restore $LASTEXITCODE. The segment helpers above run native commands | | git outside a repo exits 128, kubectl, dotnet, … that overwrite it; | | without this, those internal codes leak into the NEXT render as a phantom | | "✘ 128" / "✘ 1" even when you only pressed Enter. | | $global:LASTEXITCODE = $RealLastExit | | | | if $script:SupportsAnsi { | | ── PS7: write everything as a single ANSI string ──────────────────── | | return " n$line1 n$ Styled $glyphColor $glyph " | | } else { | | ── PS5: flush queued Write-Host calls, then return glyph ───────────── | | Write-Host " n" -NoNewline | | foreach $piece in $script:PromptPieces { | | Write-Host $piece.Text -ForegroundColor $piece.Color -NoNewline | | } | | Write-Host " n" -NoNewline | | Write-Host $glyph -ForegroundColor $glyphColor -NoNewline | | return ' ' | | } | | } | | | | ── Minimal prompt Constrained Language + last-resort fallback ───────────── | | Constrained-Language-safe: cmdlets + operators only — no .NET method/ctor/type | | calls, no ANSI, no native commands, no font-dependent glyphs. This is what a | | locked-down or exotic host gets, and what the catch-all below falls back to. | | function script:Get-MinimalPrompt { | | param $RealLastExit | | $loc = Get-Location .Path | | $code = if $RealLastExit -and $RealLastExit -ne 0 { " $RealLastExit " } else { '' } | | $depth = ' ' 1 + $NestedPromptLevel | | return "PS $loc$code$depth " | | } | | | | function global:prompt { | | Canonical state capture FIRST — before Set-PromptTitle or any segment runs a | | native command git, kubectl, dotnet, … . $realLastExit preserves the user's | | exit code; $errMark lets the finally scrub the prompt's OWN native-command | | noise from $Error Windows PowerShell 5.1 records git/kubectl stderr there | | even with 2 $null — PS7 does not . | | $realLastExit = $global:LASTEXITCODE | | $errMark = $global:Error.Count | | try { | | if $script:SupportsTitle { Set-PromptTitle } | | if $script:ConstrainedLang { return Get-MinimalPrompt $realLastExit } | | return Get-RichPrompt $realLastExit | | } catch { | | Never let an unexpected prompt error drop the shell to the bare "PS ". | | return Get-MinimalPrompt $realLastExit | | } finally { | | $global:LASTEXITCODE = $realLastExit | | Drop only the error records the prompt itself just added they sit at the | | front of $Error ; the user's earlier errors are left untouched. | | while $global:Error.Count -gt $errMark { $global:Error.RemoveAt 0 } | | } | | } | | | | ============================================================================= | | SECTION 5 – TITLE BAR | | Updates the window/tab title to show current path & process name. | | Called directly from the prompt above only when $script:SupportsTitle, and | | still guarded so a mid-session failure can't take the prompt down. | | ============================================================================= | | | | function script:Set-PromptTitle { | | $location = $PWD.ProviderPath | | $home path = $HOME | | if $home path -and $location.StartsWith $home path, $script:PathComparison { | | $location = '~' + $location.Substring $home path.Length | | } | | $proc = if $script:PS7 { 'pwsh' } else { 'powershell' } | | Not every host exposes a settable RawUI.WindowTitle some remoting/embedded | | hosts throw, or RawUI is $null ; isolate it so a title failure never | | downgrades the whole prompt. | | try { $host.UI.RawUI.WindowTitle = "$proc $location" } catch { } | | } | | | | ============================================================================= | | SECTION 6 – PSReadLine INTEGRATION PS5 + PS7 | | Multi-line editing, history search, smart paste | | ============================================================================= | | | | Interactive sessions only — scripts/CI don't render a prompt or read keys. | | if $script:IsInteractive -and Get-Module -Name PSReadLine -ListAvailable -ErrorAction SilentlyContinue { | | Import-Module PSReadLine -ErrorAction SilentlyContinue | | | | Set-PSReadLineOption -EditMode Windows | | Set-PSReadLineOption -HistorySearchCursorMovesToEnd | | Set-PSReadLineOption -MaximumHistoryCount 10000 | | Set-PSReadLineOption -HistoryNoDuplicates | | | | Up/Down searches history that starts with current input | | Set-PSReadLineKeyHandler -Key UpArrow -Function HistorySearchBackward | | Set-PSReadLineKeyHandler -Key DownArrow -Function HistorySearchForward | | | | Ctrl+D exits cleanly | | Set-PSReadLineKeyHandler -Key 'Ctrl+d' -Function DeleteCharOrExit | | | | if $script:PS7 { | | Predictive IntelliSense from history PS7 + PSReadLine 2.1+ | | try { | | Set-PSReadLineOption -PredictionSource History | | } catch { } | | } | | } | | | | ============================================================================= | | SECTION 7 – CONVENIENCE ALIASES & FUNCTIONS | | ============================================================================= | | | | Quick profile reload | | function Reload-Profile { . $PROFILE } | | Set-Alias -Name rp -Value Reload-Profile -Force -Scope Global | | | | Open profile in VS Code falls back to notepad | | function Edit-Profile { | | if CommandExists 'code' { code $PROFILE } | | elseif CommandExists 'notepad++' { & 'notepad++' $PROFILE } | | else { notepad $PROFILE } | | } | | Set-Alias -Name ep -Value Edit-Profile -Force -Scope Global | | | | Toggle the optional git stash ≡ / worktree ⎇ indicators for this session. | | They're off by default because each adds a git process to every prompt render. | | function Enable-GitExtras { $script:GitShowExtras = $true; Write-Host 'Git stash/worktree indicators: ON' -ForegroundColor Green } | | function Disable-GitExtras { $script:GitShowExtras = $false; Write-Host 'Git stash/worktree indicators: OFF' -ForegroundColor DarkGray } | | | | ============================================================================= | | END OF PROFILE | | ============================================================================= |