Skip to main content
Gentleman Guardian Angel (gga) runs on every git commit, sending your staged files to an AI for review against your coding standards. If the code passes, the commit goes through. If it fails, the commit is blocked with a detailed explanation of every violation. Works with Claude, Gemini, Codex, OpenCode, Ollama, LM Studio, GitHub Models — or any AI CLI you have installed.

Quick Start

Install gga and run your first AI code review in under 5 minutes

How It Works

Understand the commit flow, AI prompt structure, and pass/fail logic

Providers

Set up Claude, Gemini, Ollama, GitHub Models, and more

Command Reference

Full reference for every gga command and flag

​
Why GGA?

You have coding standards. Your team ignores them. Code reviews catch issues too late. GGA runs on every commit — like having a senior developer review every line before it hits the repo. 
┌─────────────────┐     ┌──────────────┐     ┌─────────────────┐
│   git commit    │ ──▶ │  AI Review   │ ──▶ │  ✅ Pass/Fail   │
│  (staged files) │     │  (any LLM)   │     │  (with details) │
└─────────────────┘     └──────────────┘     └─────────────────┘

Zero dependencies

Pure Bash — no Node, Python, or Go required. Works on macOS, Linux, Windows (Git Bash), and WSL.

Provider agnostic

Use any AI: local models via Ollama or LM Studio, or cloud APIs via Claude, Gemini, Codex, and GitHub Models.

Smart caching

Files that haven’t changed are skipped automatically. Only new or modified files are reviewed.

CI/CD ready

Run in GitHub Actions, GitLab CI, or any pipeline with --ci and --pr-mode flags.

​
Get started in 3 steps

1

Install gga

brew install gentleman-programming/tap/gga
Or install manually — see the Quick Start guide.
2

Initialize your project

cd ~/your-project
gga init      # creates .gga config
gga install   # installs pre-commit hook
3

Create your coding standards

Create an AGENTS.md file with the rules your AI reviewer should enforce. Every commit is now reviewed automatically.See Writing your rules file for best practices and examples.
GGA requires only Bash 5.0+ and an AI provider CLI installed on your machine. No API wrappers, no SDKs, no package managers needed.

Build docs developers (and LLMs) love

Get started for freeTalk to us