🛠️ Gemini CLI: Manual Update Guide

If the automatic update fails or you need to force a specific version of the Gemini CLI, use these steps.

🔴 Symptom: Automatic Update Failed

You may see an error message like: ✕ Automatic update failed. Please try updating manually

🟢 Manual Update Procedure

1. Verify Current Version

Check the version currently installed on your system:

gemini --version

2. Check Latest Version

Query the npm registry for the latest available version:

npm show @google/gemini-cli version

3. Perform Manual Update

Use npm with sudo to update the global package:

sudo npm install -g @google/gemini-cli@latest

4. Confirm Update

Verify that the new version is active:

gemini --version

🛠️ Troubleshooting Update Failures

Permissions Issues

If you encounter EACCES errors without sudo, ensure your user has permissions or use sudo as shown above.

Registry Connectivity

If npm cannot reach the registry, check your internet connection or any local firewall/proxy settings.

Cache Issues

If the version doesn't update, try clearing the npm cache:

npm cache clean --force