Install GitAI Developer

1

Install the CLI

Choose your preferred installation method to get the AI Developer CLI on your machine.

curl -sSL https://ai.checkout.ingka.com/install.sh | bash

This script auto-detects your OS and architecture, downloads the latest release, and installs to /usr/local/bin.

Download the binary for your platform:

🍎 macOS Apple Silicon (M1/M2/M3) 🍎 macOS Intel (x86_64) 🐧 Linux AMD64 (x86_64) 🐧 Linux ARM64 (aarch64)

                        # After downloading, make it executable and move to PATH
chmod +x ai-dev_*
sudo mv ai-dev_* /usr/local/bin/ai
                    

2

Configure Your Repository

Run the setup wizard to generate GitHub Actions workflows and AI task prompts.

# Navigate to your repository
cd your-repository

# Run the setup wizard
ai github install

The wizard will guide you through:

✓ Authentication Method Choose between Vertex AI (recommended for orgs) or Gemini API Key
✓ Model Selection Select the default Gemini model for your tasks
✓ Workflow Selection Choose which automated workflows to enable
✓ AI Planning Enable self-improving task scheduling (optional)

💡 The wizard creates files in .ai/ and .github/workflows/. Review and commit these to activate AI Developer in your repository.

3

Configure GitHub Secrets

Add the required secrets to your GitHub repository for authentication.

For organisations using Google Cloud and Workload Identity Federation:

1 WIF_PROVIDER Your Workload Identity Provider resource name
2 WIF_SERVICE_ACCOUNT Service account email with Vertex AI access

📚 See our organisation setup guide for detailed instructions on configuring Workload Identity Federation.

For simpler setups using a Gemini API key:

1 Get an API Key Visit ai.google.dev to create a free API key
2 Add to GitHub Secrets Create a secret named GEMINI_API_KEY

                        # Add secret via GitHub CLI
gh secret set GEMINI_API_KEY
                    

4

Commit and Activate

Push the generated files to activate AI Developer in your repository.

# Stage the generated files
git add .ai .github/workflows/ai-*.yml

# Commit the changes
git commit -m "Add AI Developer setup"

# Push to activate
git push

What Happens Next

⏰

Scheduled Run

Tasks run on schedule

→

🤖

AI Works

Analyses & improves

→

📝

Creates PR

Proposes changes

→

✅

You Review

Merge or reject

🎉 You're all set!
GitAI Developer will start running on schedule. Check the Actions tab in GitHub to monitor executions.

Get Started with GitAI Developer