Installation

​

Homebrew

brew install grantiva/tap/grantiva

​

From source

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

grantiva doctor

​

Authenticate

​

Browser login (interactive)

grantiva auth login

​

API key (CI/headless)

grantiva auth login --api-key YOUR_API_KEY

export GRANTIVA_API_KEY="your-api-key"

​

Check auth status

grantiva auth status

​

Logout

grantiva auth logout

​

Next steps

• VRT Concepts — how the CLI driver works, baseline lifecycle, and auth model
• VRT Quick Start — capture your first screenshots in under 10 minutes
• CLI Commands — full reference for all grantiva commands
• CI Integration — GitHub Actions, pre-built binaries, and parallel runs