Troubleshooting

rimo: command not found

The install directory is not on your PATH. The installer prints the line to add; for the default location:

export PATH="$HOME/.local/bin:$PATH"

Add it to your shell profile (~/.zshrc, ~/.bashrc, …) and restart the shell.

permission denied when running rimo

Ensure the binary is executable:

chmod +x ~/.local/bin/rimo

macOS: "Apple could not verify 'rimo' is free of malware"

If macOS Gatekeeper blocks the binary on first run, clear the quarantine attribute:

xattr -d com.apple.quarantine ~/.local/bin/rimo

(Binaries installed via the curl … | sh one-liner are normally not quarantined, so you usually only hit this with a manual browser download.)

rimo auth login does not open a browser

If the browser doesn't open automatically, run with --no-browser:

rimo auth login --no-browser

rimo prints a URL you can open on any other device (phone, another laptop). After signing in there, paste the short code shown on the page back into your terminal.

--no-browser code is rejected or expires

The short code shown on the consent page is short-lived. Re-run rimo auth login --no-browser to get a fresh URL and complete the browser step promptly. Codes are case-sensitive and use the form XXXX-XXXX — paste them exactly as shown.

Behind a proxy or firewall

The CLI talks to https://rimo.app and https://api.github.com (the latter for installs/upgrades). Ensure outbound HTTPS to both is allowed, and that your HTTPS_PROXY environment variable is set if you use a proxy.

A stale version keeps running

Check which binary is first on your PATH:

which -a rimo
rimo version

Remove older copies, or re-run the install script to refresh ~/.local/bin/rimo.

Checksum mismatch during install

The downloaded archive did not match checksums.txt. Re-run the install — a partial/corrupted download is the usual cause. If it persists, report it via the Security Policy.

Still stuck? Open an issue in this repository with your rimo version, OS, and the exact command and output.