Ravi

Installation

Install with Homebrew

The fastest way to install the Ravi CLI on macOS or Linux:

brew install ravi-hq/tap/ravi

Or in one line:

brew install ravi-hq/tap/ravi

To update later:

brew update && brew upgrade ravi

Pre-built binaries

Download the latest release for your platform from the GitHub releases page. Binaries are available for:

  • macOS (Apple Silicon and Intel)
  • Linux (amd64 and arm64)

Build from source

Requires Go 1.21+:

git clone https://github.com/ravi-hq/cli.git
cd cli
make build API_URL=https://ravi.app

The built binary will be at ./ravi. Move it to a directory on your $PATH.

Verify installation

ravi --version

Sign up

If you don’t have a Ravi account yet, sign up at ravi.app.

Authenticate

Log in with the CLI:

ravi auth login

This opens your browser for OAuth authentication. After completing the browser flow, the CLI stores your credentials at ~/.ravi/auth.json with secure file permissions.

First-time users will be prompted to create a 6-digit encryption PIN. This PIN derives the encryption keys for your credential vault — the server never sees it.

Verify authentication

ravi auth status --json

Next steps