Skip to main content

Documentation Index

Fetch the complete documentation index at: https://rendobar.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Run this first: 
rb doctor
It runs eight checks and prints a fix: line under any failure. Most entries on this page surface there directly. rb doctor --fix removes the macOS quarantine bit if needed.

​
Install + PATH

rb: command not found after install. Three causes:
  1. The shell hasn’t reloaded. Open a new terminal, or source ~/.zshrc / ~/.bashrc.
  2. You set RENDOBAR_NO_MODIFY_PATH=1. Add the dir yourself: export PATH="$HOME/.rendobar/bin:$PATH".
  3. Custom RENDOBAR_INSTALL_DIR not on PATH. Same fix.
Verify the binary exists: ls -l ~/.rendobar/bin/rb. curl: (22) … 403 or 429 during install. GitHub Releases rate limit (60/hr per IP unauthenticated). Pass a token: 
RENDOBAR_GITHUB_TOKEN=ghp_xxx curl -fsSL https://rendobar.com/install.sh | sh
In GitHub Actions, the default GITHUB_TOKEN is auto-picked-up. Error: need curl or wget. Minimal Docker images don’t ship either. apt-get install -y curl ca-certificates (Debian/Ubuntu) or apk add curl ca-certificates (Alpine), then re-run. Checksum verification failed. Rare, usually transient corruption. Re-run. If it persists, file an issue with the version + platform at rendobar/cli/issues.

​
macOS Gatekeeper

"rb" cannot be opened because the developer cannot be verified. The binary picked up com.apple.quarantine (browser download or some download managers; curl | sh does not trigger it). 
rb doctor --fix
# or
xattr -d com.apple.quarantine $(which rb)

​
Login

Port 14832 in use. Another process holds the OAuth callback port. Free it (lsof -i :14832) or skip the browser flow: rb login --key rb_live_xxx. Login timed out. The browser flow waits 120 seconds. Re-run rb login. If your network blocks loopback HTTP (some corporate firewalls do), use --key instead. Browser didn’t open. Copy the URL from stderr into any browser. The flow completes the same way. Refresh failed: invalid_grant. Refresh token revoked or expired. rb logout && rb login.

​
Running jobs

Not authenticated. Run rb login or set RENDOBAR_API_KEY. No credentials saved or file corrupt. Pick one:
  • Interactive: rb login
  • CI: export RENDOBAR_API_KEY=rb_live_xxx
  • Inspect what the CLI sees: rb whoami
Insufficient credits. Exits 2 with a top-up link. Top up at app.rendobar.com/billing. Check balance with rb whoami. Job failed with no useful message. Re-run with --json to capture the full error envelope: 
rb ffmpeg --json -i in.mp4 -c:v libx264 out.mp4 | jq .
error.code and error.message are the canonical failure reason. Local input file isn’t being uploaded. The CLI treats arguments after -i as inputs. A local input is detected only when the path is after -i, doesn’t look like a URL, and exists on disk. Custom filter graphs reading files via movie= won’t be detected — upload manually and pass a URL.

​
Update

rb update keeps offering the same version. Stale or corrupt update cache: 
rm ~/.rendobar/update-check.json
rb update
Update failed: write permission denied. The install dir isn’t writable by your user. Neither the installer nor rb update calls sudo. Re-install under sudo, or relocate: 
# Sudo to system path
RENDOBAR_INSTALL_DIR=/usr/local/bin \
  curl -fsSL https://rendobar.com/install.sh | sudo -E sh

# User-writable (default)
RENDOBAR_INSTALL_DIR=$HOME/.rendobar/bin \
  curl -fsSL https://rendobar.com/install.sh | sh
rb still reports the old version. Multiple rb binaries on PATH: 
which -a rb       # macOS / Linux
Get-Command rb -All   # Windows
First match wins. Remove the stale copy or reorder PATH.

​
Network and proxies

Behind a corporate proxy. Bun’s fetch respects HTTPS_PROXY, HTTP_PROXY, NO_PROXY: 
export HTTPS_PROXY=http://proxy.corp.local:8080
export NO_PROXY=127.0.0.1,localhost
rb login
NO_PROXY=127.0.0.1 is required for the OAuth callback to reach loopback without going through the proxy. Custom CA bundle. Set NODE_EXTRA_CA_CERTS: 
export NODE_EXTRA_CA_CERTS=/etc/ssl/certs/corp-ca-bundle.pem
rb whoami
A TLS error like unable to verify the first certificate is the symptom. api.rendobar.com unreachable. Run rb doctor. It hits https://api.rendobar.com/health with a 5 s timeout. If curl to the same URL works from the same machine, it’s a proxy or CA bundle (above).

​
Still stuck

​
See also