Skip to main content

​
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