Skip to content

docs: replace removed npm bin -g in install debugging#45

Merged
BunsDev merged 3 commits into
mainfrom
docs/fix-npm-bin-removed
Jul 22, 2026
Merged

docs: replace removed npm bin -g in install debugging#45
BunsDev merged 3 commits into
mainfrom
docs/fix-npm-bin-removed

Conversation

@BunsDev

@BunsDev BunsDev commented Jul 22, 2026

Copy link
Copy Markdown
Member

Summary

npm bin was removed in npm 9, so the PATH check in the install-debugging reference fails on any modern npm. This swaps it for npm prefix -g and notes where the global bin directory lives per platform — matching the wording the fix-a-failed-install guide adopted while addressing review feedback (#41).

Why now

Resolving the Copilot review threads on the guides stack left the guide using npm prefix -g while this reference still taught the removed command.

🤖 Generated with Claude Code

npm 9 removed `npm bin`; the PATH check in the install-debugging
reference silently fails on any modern npm. Use `npm prefix -g` and
note where the bin directory lives per platform, matching the
fix-a-failed-install guide.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings July 22, 2026 00:40
@vercel

vercel Bot commented Jul 22, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
coven-docs Ready Ready Preview Jul 22, 2026 3:50am

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the CLI install debugging documentation to avoid the removed npm bin -g command by switching to npm prefix -g, keeping the “global bin on PATH” troubleshooting steps usable on modern npm versions.

Changes:

  • Replaces npm bin -g with npm prefix -g in the “npm global install” PATH verification snippet.
  • Adds an explanatory note describing where the global bin directory lives on macOS/Linux vs Windows.

Comment thread content/docs/cli/install-debugging.mdx Outdated
BunsDev and others added 2 commits July 21, 2026 22:47
The PATH grep compared entries against npm prefix -g, but the
directory that must be on PATH is <prefix>/bin on macOS/Linux.
Use grep -Fx against "$(npm prefix -g)/bin" for an exact-entry
check in install-debugging and the fix-a-failed-install guide,
and note the Windows difference explicitly.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
BunsDev merged commit c497e5b into main Jul 22, 2026
1 check passed
@BunsDev
BunsDev deleted the docs/fix-npm-bin-removed branch July 22, 2026 03:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants