## Install The CLI

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

```bash
brew install ravi-hq/tap/ravi
```

Prebuilt release archives are published from the CLI repository:

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

## Build From Source

```bash
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:

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

## Authenticate

For local CLI use:

```bash
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:

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

## Next Steps

- [Authentication](/getting-started/authentication/)
- [API Overview](/api/overview/)
- [API Endpoints](/api/endpoints/)