Skip to main content

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.

​
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
This checks your environment: macOS version, Xcode installation, Swift version, simulator availability, and command-line tools.

​
Authenticate

​
Browser login (interactive)

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

​
API key (CI/headless)

grantiva auth login --api-key YOUR_API_KEY
Or use environment variables: 
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