Ravi

Installation

Install The CLI

On macOS or Linux, install the CLI from the Ravi Homebrew tap:

brew install ravi-hq/tap/ravi

Prebuilt release archives are published from the CLI repository:

https://github.com/ravi-hq/cli/releases

Build From Source

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

The built binary is ./ravi.

Verify The Backend

Before debugging local auth or CLI state, verify that the production API is reachable:

curl https://api.ravi.app/api/health/ping/

Authenticate

For local CLI use:

ravi auth login

For automated use, prefer an API key created for the narrowest useful scope:

  • ravi_id_... for one identity
  • ravi_mgmt_... for broader management workflows

Pass API keys as bearer tokens when calling the REST API directly:

curl https://api.ravi.app/api/health/whoami/ \
  -H "Authorization: Bearer ravi_mgmt_..."

Next Steps