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.

Install the rb binary in one command, on any of the three supported platforms.
curl -fsSL https://rendobar.com/install.sh | sh
The installer fetches the matching release from github.com/rendobar/cli/releases, verifies a SHA-256 checksum, places rb at ~/.rendobar/bin/rb (or %USERPROFILE%\.rendobar\bin\rb.exe), and adds that directory to your PATH. Open a new shell, then:
rb --version
rb doctor
rb doctor runs eight checks: version vs latest, install method, OS/arch, update cache, API reachability, auth, macOS quarantine, GitHub rate limit.

Pin a version

Reproducible installs (CI, Dockerfile, provisioning) require a pinned tag:
RENDOBAR_VERSION=v1.0.0 curl -fsSL https://rendobar.com/install.sh | sh
$env:RENDOBAR_VERSION = 'v1.0.0'; irm https://rendobar.com/install.ps1 | iex
Tag format: vMAJOR.MINOR.PATCH. See releases for every published tag.

Inspect before piping to a shell

Both installers are POSIX sh / PowerShell 5+, source-visible, no bash-isms: To read first:
curl -fsSL https://rendobar.com/install.sh -o install.sh
less install.sh
sh install.sh

Update

rb update
Downloads the new release, verifies the SHA-256, atomically replaces the running binary, rolls back if the new binary fails to start. Log at ~/.rendobar/update.log. In dev mode (bun run), rb update prints the install command instead of self-replacing.

Verify build provenance

Every release ships with a build provenance attestation signed by GitHub’s OIDC issuer:
curl -fsSL -o rb.tar.gz \
  https://github.com/rendobar/cli/releases/download/v1.0.0/rb-linux-x64.tar.gz
gh attestation verify rb.tar.gz --repo rendobar/cli
Use this when your supply-chain policy requires it.

Uninstall

curl -fsSL https://rendobar.com/uninstall.sh | sh
The uninstaller removes the binary and the PATH entry. Add RENDOBAR_PURGE=1 to also wipe ~/.rendobar/ (update cache + log).
RENDOBAR_PURGE does not delete saved credentials at ~/.config/rendobar/credentials.json (or %APPDATA%\rendobar\credentials.json). Run rb logout first, or delete the file manually.

Environment variables

VariableUsed byDefaultPurpose
RENDOBAR_VERSIONinstalllatest stablePin to a release tag (e.g. v1.0.0)
RENDOBAR_INSTALL_DIRinstall + uninstall$HOME/.rendobar/binBinary directory
RENDOBAR_CONFIG_DIRuninstall$HOME/.rendobarCache directory cleaned by RENDOBAR_PURGE=1
RENDOBAR_NO_MODIFY_PATHinstall + uninstallunsetIf 1, skip touching shell rc / user PATH
RENDOBAR_GITHUB_TOKENinstallunsetLift GitHub’s 60/hr unauth rate limit. Falls back to GITHUB_TOKEN
RENDOBAR_PURGEuninstallunsetIf 1, also delete the cache directory
RENDOBAR_API_KEYruntimeunsetAuth for non-interactive use. See Authentication
RENDOBAR_API_URLruntimehttps://api.rendobar.comOverride the API host

See also