> ## Documentation Index
> Fetch the complete documentation index at: https://docs.grantiva.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Install the Grantiva CLI for visual regression testing

## Homebrew

```bash theme={null}
brew install grantiva/tap/grantiva
```

## From source

```bash theme={null}
git clone https://github.com/grantiva/cli.git
cd cli
swift build -c release
cp .build/release/grantiva /usr/local/bin/grantiva
```

## Requirements

* macOS 15+
* Xcode 16+
* Swift 6.1+

## Verify installation

```bash theme={null}
grantiva doctor
```

This checks your environment: macOS version, Xcode installation, Swift version, simulator availability, and command-line tools.

## Authenticate

### Browser login (interactive)

```bash theme={null}
grantiva auth login
```

Opens your browser for login. Credentials are saved to `~/.grantiva/auth.json`.

### API key (CI/headless)

```bash theme={null}
grantiva auth login --api-key YOUR_API_KEY
```

Or use environment variables:

```bash theme={null}
export GRANTIVA_API_KEY="your-api-key"
```

### Check auth status

```bash theme={null}
grantiva auth status
```

### Logout

```bash theme={null}
grantiva auth logout
```

## Next steps

* [VRT Concepts](/concepts/vrt) — how the CLI driver works, baseline lifecycle, and auth model
* [VRT Quick Start](/quickstart-vrt) — capture your first screenshots in under 10 minutes
* [CLI Commands](/cli/commands) — full reference for all `grantiva` commands
* [CI Integration](/cli/ci-integration) — GitHub Actions, pre-built binaries, and parallel runs