From ab4a274763d08b8c3dd7498c659fb37d28ccc41d Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Mon, 20 Apr 2026 21:38:53 +0000
Subject: [PATCH 1/2] Add troubleshooting entry for npx version resolution fix

Generated-By: mintlify-agent
---
 cli/install.mdx | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/cli/install.mdx b/cli/install.mdx
index e2670db3f..80dee70ba 100644
--- a/cli/install.mdx
+++ b/cli/install.mdx
@@ -123,4 +123,16 @@ For syntax highlighting and code formatting in MDX files, we recommend using the
 
     **Solution**: Ask your IT administrator to add `releases.mintlify.com` to your network allowlist.
   </Accordion>
+  <Accordion title="CLI connects to localhost instead of production when using npx">
+    In versions before 4.0.1125, running `npx mint dev` or other commands from a docs
+    repository could cause the CLI to incorrectly detect itself as a local development
+    build. This made the CLI point to `localhost` URLs instead of the Mintlify production
+    API, resulting in connection errors or unexpected behavior.
+
+    **Solution**: Update to the latest CLI version:
+
+    ```bash
+    npm i -g mint@latest
+    ```
+  </Accordion>
 </AccordionGroup>

From ba5605bb36e4f4a4dae405cbec7d5a0020a1d727 Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Fri, 24 Apr 2026 10:48:23 -0700
Subject: [PATCH 2/2] Apply suggestion from @ethanpalm

---
 cli/install.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/cli/install.mdx b/cli/install.mdx
index 80dee70ba..5da339147 100644
--- a/cli/install.mdx
+++ b/cli/install.mdx
@@ -124,7 +124,7 @@ For syntax highlighting and code formatting in MDX files, we recommend using the
     **Solution**: Ask your IT administrator to add `releases.mintlify.com` to your network allowlist.
   </Accordion>
   <Accordion title="CLI connects to localhost instead of production when using npx">
-    In versions before 4.0.1125, running `npx mint dev` or other commands from a docs
+    In versions before `4.0.1125`, running `npx mint dev` or other commands from a docs
     repository could cause the CLI to incorrectly detect itself as a local development
     build. This made the CLI point to `localhost` URLs instead of the Mintlify production
     API, resulting in connection errors or unexpected behavior.