Skip to content

Add CLI troubleshooting for npx version resolution#5457

Merged
ethanpalm merged 2 commits intomainfrom
mintlify/cli-npx-troubleshooting-1776721079
Apr 24, 2026
Merged

Add CLI troubleshooting for npx version resolution#5457
ethanpalm merged 2 commits intomainfrom
mintlify/cli-npx-troubleshooting-1776721079

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify Bot commented Apr 20, 2026

Summary

  • Adds a troubleshooting entry to the CLI install page for a bug where running CLI commands via npx could cause the CLI to incorrectly connect to localhost instead of the production API.
  • The fix shipped in CLI version 4.0.1125. The troubleshooting entry helps users on older versions identify and resolve the issue.

Triggered by mintlify/mint@9af367ee, which includes a fix for CLI version resolution when invoked via npx.


Note

Low Risk
Low risk: documentation-only change with no runtime or security impact.

Overview
Adds a new Troubleshooting accordion to cli/install.mdx for a pre-4.0.1125 issue where running mint via npx could make the CLI connect to localhost instead of production, and directs users to update via npm i -g mint@latest.

Reviewed by Cursor Bugbot for commit ba5605b. Bugbot is set up for automated code reviews on this repo. Configure here.

@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify Bot commented Apr 20, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
mintlify 🟢 Ready View Preview Apr 20, 2026, 9:41 PM

@mintlify-development
Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
userauth 🟡 Building Apr 20, 2026, 9:39 PM

Comment thread cli/install.mdx Outdated
@ethanpalm ethanpalm merged commit f3c02ae into main Apr 24, 2026
5 checks passed
@ethanpalm ethanpalm deleted the mintlify/cli-npx-troubleshooting-1776721079 branch April 24, 2026 17:48
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.

1 participant