MDM Deployment

Git AI is a single binary that tracks AI authorship across your organization.

Requirements

Installation Steps

Place the git-ai binary on each developer machine. The default location is:

• Unix/Linux/macOS: $HOME/.git-ai/bin/git-ai
• Windows: %USERPROFILE%\.git-ai\bin\git-ai.exe

The binary is a platform-specific download from GitHub Releases (e.g. git-ai-macos-arm64, git-ai-linux-x64, git-ai-windows-x64.exe). On macOS, remove the quarantine attribute after downloading:

xattr -d com.apple.quarantine $HOME/.git-ai/bin/git-ai

Reference install scripts that automate this:

• Unix/Linux/macOS: install.sh
• Windows: install.ps1

After installing the binary, run:

git ai install-hooks

This sets up integration with supported IDEs and AI coding agents (Cursor, VS Code with GitHub Copilot, etc.). Once complete, telemetry from every supported coding agent begins flowing to the dashboard.

Configuration File

Create $HOME/.git-ai/config.json (or %USERPROFILE%\.git-ai\config.json on Windows) with organization settings. See Enterprise Configuration for the full option reference.

{
    "ignore_prompts": false,
    "allow_repositories": [
        "https://github.com/yourorg/*"
    ]
}

MDM Deployment

For enterprise deployments, use your MDM solution to:

1. Distribute the binary — package and deploy git-ai to each machine
2. Deploy configuration — push the config.json with organization settings
3. Run post-install — execute git ai install-hooks via script after installation

Optional: Wrap Git

Wrapping git by placing git-ai on the user's PATH is optional. If you wrap git, developers will see an AI authorship summary after every commit:

[hooks-doctor 0afe44b2] wsl compat check
 2 files changed, 81 insertions(+), 3 deletions(-)
you  ██░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ai
     6%             mixed   2%             92%

This adds a small ~10–20ms overhead per wrapped git command, but it's useful to spot check Git AI accuracy during PoCs.

Custom Install Scripts

The official install scripts serve as a reference for building organization-specific installers:

• Unix/Linux/macOS: install.sh
• Windows: install.ps1