Troubleshooting - Browser Agent CLI

Clean reinstall

If updates aren't working or you're seeing version mismatches, do a clean reinstall:

Windows (PowerShell) - RECOMMENDED

npm uninstall -g rird-ai; Remove-Item -Recurse -Force "$env:USERPROFILE\.rird" -ErrorAction SilentlyContinue; npm install -g rird-ai

Windows (Command Prompt)

npm uninstall -g rird-ai && rmdir /s /q "%USERPROFILE%\.rird" 2>nul & npm install -g rird-ai

macOS / Linux

npm uninstall -g rird-ai && rm -rf ~/.rird && npm install -g rird-ai

Alternative: curl script (Mac/Linux only)

rm -rf ~/.rird && curl -fsSL https://rird.ai/install.sh | bash

Manual update

Update to the latest version:

All platforms (Windows, Mac, Linux)

npm install -g rird-ai@latest

Or use the built-in command

rird upgrade

Alternative: curl script (Mac/Linux only)

curl -fsSL https://rird.ai/install.sh | bash

Check installed version

CLI version

rird --version

Agent version

cat ~/.rird/engine/.version

Reset agent (force re-download)

If the agent is behaving unexpectedly, reset it:

PowerShell (Windows)

Remove-Item -Path "$env:USERPROFILE\.rird\engine\.version" -Force; rird --setup

Bash (macOS/Linux)

rm -f ~/.rird/engine/.version && rird --setup

Common issues

"Update failed" message

Auto-update failed due to permissions. Run manual update:

curl -fsSL https://rird.ai/install.sh | bash

Version mismatch after update

Cached version mismatch. Do a clean reinstall (see above).

"command not found: rird"

Shell not reloaded after install. Try:

source ~/.bashrc

Or open a new terminal window.

Python not found

Install Python 3.10+ and ensure it's in PATH:

Windows: winget install Python.Python.3.12

macOS: brew install python@3.12

Linux: sudo apt install python3.12

Still stuck?

If none of the above works, try a full reset:

# Windows (PowerShell)

npm uninstall -g rird-ai; Remove-Item -Recurse -Force "$env:USERPROFILE\.rird" -ErrorAction SilentlyContinue; npm cache clean --force; npm install -g rird-ai

# macOS / Linux

npm uninstall -g rird-ai && rm -rf ~/.rird && npm cache clean --force && npm install -g rird-ai