setup-notes-store.md

Connect and Reduce Privileges

1. Log in to Git AI.
2. Connect your repositories. During the initial connection, the OAuth app must be granted the requested permissions. After the connection is complete, you can reduce its permissions.
3. In Microsoft Entra ID or Azure DevOps, remove the Write permission from the OAuth application.

---

Create a Telemetry API Key

1. Go to Settings → API Keys and click Create Key.
2. Grant the following permissions:
   • Telemetry: Write
   • Notes: Read
   • Notes: Write
3. Save the API key.

---

Install on Each Client

Provide the following instructions to everyone participating in the PoC.

For a broad rollout, we strongly recommend using an MDM solution, especially because of the additional configuration required for the Notes backend.

Install Git AI

# macOS
curl -sSL https://usegitai.com/install.sh | bash

# Windows
powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://usegitai.com/install.ps1 | iex"

Configure Git AI

git-ai config set api_key <api_token>
git-ai config set notes_backend.kind http
git-ai config set notes_backend.backend_url https://usegitai.com
git-ai bg restart