Arcade CLI upgrade path

app/en/references/arcade-cli/page.mdx

@@ -35,6 +35,47 @@ In your terminal, run the following command to install the `arcade-mcp` package
   </Tabs.Tab>
 </Tabs>
 
+## Upgrade the Arcade CLI
+
+To upgrade to the latest version of the Arcade CLI, run the appropriate command for your package manager:
+
+<Tabs items={["uv", "pip"]}>
+  <Tabs.Tab>
+
+  ```bash
+  uv tool upgrade arcade-mcp
+  ```
+
+  </Tabs.Tab>
+
+  <Tabs.Tab>
+
+  ```bash
+  pip install --upgrade arcade-mcp
+  ```
+
+  </Tabs.Tab>
+</Tabs>
+
+After upgrading, verify the installation:
+
+```bash
+arcade --version
+```
+
+<Callout type="info">
+If you previously had the `arcade-ai` package installed, you should uninstall it first. The old `arcade-ai` CLI has been replaced by `arcade-mcp`. See the [migration guide](/guides/create-tools/migrate-toolkits) for details on migrating from legacy toolkits.
+</Callout>
+
+### Re-authenticate after upgrading
+
+After upgrading, you may need to refresh your credentials:
+
+```bash
+arcade logout
+arcade login
+```
+
 ## Usage
 
 ```bash

app/en/references/cli-cheat-sheet/page.mdx

@@ -30,6 +30,13 @@ import '../../../cheat-sheet-print.css'
     pip install arcade-mcp        # Alternative
     ```
 
+    Upgrade to the latest version:
+
+    ```bash
+    uv tool upgrade arcade-mcp    # Recommended
+    pip install --upgrade arcade-mcp  # Alternative
+    ```
+
     Verify installation:
 
     ```bash
@@ -537,6 +544,15 @@ import '../../../cheat-sheet-print.css'
     | "Module not found" | Run `uv pip install arcade-mcp[evals]` |
     | "Server not healthy" | Check `arcade server logs <name> -f` |
     | "No tools found" | Verify `--tool-package` or `--discover-installed` |
+    | "Command not found after upgrade" | Re-authenticate: `arcade logout && arcade login` |
+
+    ### After Upgrading
+    If you encounter issues after upgrading the CLI:
+    ```bash
+    arcade logout          # Clear old credentials
+    arcade login           # Re-authenticate
+    arcade whoami          # Verify login status
+    ```
 
     ### Debug Tips
     ```bash

public/_markdown/en/references/arcade-cli.md

@@ -26,6 +26,39 @@ This will install the Arcade CLI as a [uv tool](https://docs.astral.sh/uv/guides
 pip install arcade-mcp
 ```
 
+## Upgrade the Arcade CLI
+
+To upgrade to the latest version of the Arcade CLI, run the appropriate command for your package manager:
+
+### uv
+
+```bash
+uv tool upgrade arcade-mcp
+```
+
+### pip
+
+```bash
+pip install --upgrade arcade-mcp
+```
+
+After upgrading, verify the installation:
+
+```bash
+arcade --version
+```
+
+If you previously had the `arcade-ai` package installed, you should uninstall it first. The old `arcade-ai` CLI has been replaced by `arcade-mcp`. See the [migration guide](/guides/create-tools/migrate-toolkits.md) for details on migrating from legacy toolkits.
+
+### Re-authenticate after upgrading
+
+After upgrading, you may need to refresh your credentials:
+
+```bash
+arcade logout
+arcade login
+```
+
 ## Usage
 
 ```bash

public/_markdown/en/references/cli-cheat-sheet.md

@@ -17,6 +17,13 @@ uv tool install arcade-mcp    # Recommended
 pip install arcade-mcp        # Alternative
 ```
 
+Upgrade to the latest version:
+
+```bash
+uv tool upgrade arcade-mcp    # Recommended
+pip install --upgrade arcade-mcp  # Alternative
+```
+
 Verify installation:
 
 ```bash
@@ -752,6 +759,20 @@ Check `arcade server logs <name> -f`
 
 Verify `--tool-package` or `--discover-installed`
 
+”Command not found after upgrade”
+
+Re-authenticate: `arcade logout && arcade login`
+
+### After Upgrading
+
+If you encounter issues after upgrading the CLI:
+
+```bash
+arcade logout          # Clear old credentials
+arcade login           # Re-authenticate
+arcade whoami          # Verify login status
+```
+
 ### Debug Tips
 
 ```bash