Conversation
The Requisite table handed Windows `winget install Microsoft.PowerShell` and the other two platforms a link to Microsoft's docs. That is backwards: Windows is the one platform where pwsh often already exists, and the two where it never does were the ones sent off to read. Both now carry a command verified against its own registry, `brew install powershell` at 7.6.6 and `sudo snap install powershell --classic` at 7.6.5 from Canonical, with the links kept as the authority for when a command rots. That rot is not hypothetical: Homebrew's powershell cask is already gone, so the `--cask` form that used to be correct now 404s. The rest removes friction found by walking the path a new user walks. The download becomes a pasteable Invoke-WebRequest rather than a browser click. "Without alias" becomes "Run it without installing" and moves ahead of the step that edits your profile, because trying it without being touched is the thing a reader wants first from a tool that manages OAuth credentials; it now also says what `help` and `usage` actually do, `help` returning before anything is resolved or created. The execution-policy fix gets a pointer from the first run instead of living only at the far end of Platform Notes, and both invocation examples use `./`, which pwsh accepts on every platform, in place of the Windows-only `.\`. Deliberately no changelog entry and no version bump: the script is byte- identical, so a release here would ship an asset nobody's copy differs from.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Documentation only.
switch_claude_account.ps1is byte-identical tov4.2.0, so this deliberately carries no version bump, no changelog entry and no release: tagging it would publish a release asset identical to the one already there. That is a knowing deviation from "a pull request takesdevelopintomainand carries a release".The trigger was a colleague declining the tool with "I'm not wrestling with PowerShell just to monitor". Walking the install path he would have walked turned up a table that gave Windows a command and sent the other two platforms off to read Microsoft's docs, which is backwards: Windows is the one platform where
pwshoften already exists.What changed
sudo snap install powershell --classicandbrew install powershell. Both were verified against their own registry rather than from memory, at 7.6.5 from Canonical (verified publisher) and 7.6.6 from Homebrew, and both clear the#Requires -Version 7.4floor.snapd, which Ubuntu ships and Fedora, Arch and RHEL do not.Invoke-WebRequestline beside the prose link.helpreturns beforescaresolves or creates anything, andusagereads slots and queries Anthropic without billing or switching the active account. Both claims were checked againstInvoke-Mainrather than assumed.docs/architecture.mdnames that heading as its owner..\to./, whichpwshaccepts on all three platforms.Shortcomings
dotnetformula, so it is a large install, and the bottle list covers Apple Silicon but appears not to cover Intel, which would mean an Intel Mac compiles. Both were judged too deep for an install table, andbrewreports them at the prompt.packages.microsoft.comapt/dnf repo, which is roughly eight lines and therefore not a table cell. The snapd caveat plus the link is the compromise.Feedback I want
.ps1.What is not done
README.mdtells a reader with one account to usesca usage -Watchinstead ofsca monitoronly inside the monitor section, where someone deciding whether to install will not reach it. Deliberately left out to keep this change to the Installation section.curl | shbootstrap and no container recipe. Both were considered and rejected: the first breaks the "no companion assets" promise and adds a security surface, the second means mounting live OAuth credentials into a container for the sake of a TUI.tools/install-powershell.shis not recommended, despite existing, being Microsoft-copyrighted and handling both platforms in one line. It appears nowhere in Microsoft Learn, calls itself companion code for a blog, and iscurl | bashas root that fetches a second script at runtime.