gentleman-guardian-angel
π Gentleman Guardian Angel (gga) - Provider-agnostic code review using AI. Use Claude, Gemini, Codex, Ollama to enforce your coding standards.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/gentleman-programming--gentleman-guardian-angel)HTML
<a href="/listings/gentleman-programming--gentleman-guardian-angel"><img src="/api/listings/gentleman-programming--gentleman-guardian-angel/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Homebrew (recommended)
brew install gentleman-programming/tap/gga
Manual
git clone https://github.com/Gentleman-Programming/gentleman-guardian-angel.git cd gentleman-guardian-angel ./install.sh
Windows (Git Bash, PowerShell, cmd.exe)
git clone https://github.com/Gentleman-Programming/gentleman-guardian-angel.git cd gentleman-guardian-angel bash install.sh echo 'export PATH="$HOME/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc
On Windows, the installer also creates `~/bin/gga.bat` so `gga` can be called from `cmd.exe` and PowerShell. Add `%USERPROFILE%\bin` to your Windows user `PATH` for those shells; `.bashrc` only affects Git Bash.
> **WSL** is also fully supported β no special configuration needed.
Oh My Zsh users
If you use [Oh My Zsh](https://ohmyz.sh/) with the `git` plugin enabled (the default), the alias `gga` will conflict with this CLI. You'll see:
git: 'gui' is not a git command. See 'git --help'.
**Fix:** Add this line to your `~/.zshrc` after the Oh My Zsh source line:
unalias gga 2>/dev/null
Then run `source ~/.zshrc` or open a new terminal.
---
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md Β· README Β· 180 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- <p align="center">
- <img width="1024" height="408" alt="image" src="https://github.com/user-attachments/assets/e534ba1e-0044-45c7-a788-b455733c0052" />
- </p>
- <p align="center">
- <strong>Provider-agnostic code review using AI</strong><br>
- Use Claude, Gemini, Codex, OpenCode, Cursor Agent, Kilo, Kiro, Ollama, LM Studio, GitHub Models, MiniMax, or any AI to enforce your coding standards.<br>
- Pure Bash core. Works everywhere.
- </p>
- <p align="center">
- <img src="https://img.shields.io/badge/version-2.10.1-blue.svg" alt="Version">
- <img src="https://img.shields.io/badge/license-MIT-green.svg" alt="License">
- <img src="https://img.shields.io/badge/bash-5.0%2B-orange.svg" alt="Bash">
- <img src="https://img.shields.io/badge/platforms-macOS%20%7C%20Linux%20%7C%20Windows-lightgrey.svg" alt="Platforms">
- <img src="https://img.shields.io/badge/homebrew-tap-FBB040.svg" alt="Homebrew">
- <img src="https://img.shields.io/badge/tests-266%20passing-brightgreen.svg" alt="Tests">
- <img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg" alt="PRs Welcome">
- </p>
- <p align="center">
- <a href="#-installation">Installation</a> β’
- <a href="#-quick-start">Quick Start</a> β’
- <a href="#-providers">Providers</a> β’
- <a href="#-commands">Commands</a> β’
- <a href="#-documentation">Docs</a>
- </p>
- ---
- ## Example
- <img width="962" height="941" alt="image" src="https://github.com/user-attachments/assets/c8963dff-6aa5-420c-b58b-1416e81af384" />
- ## π― Why?
- You have coding standards. Your team ignores them. Code reviews catch issues too late.
- **GGA** runs on every commit, validating staged files against your `AGENTS.md`. 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) β
- βββββββββββββββββββ ββββββββββββββββ βββββββββββββββββββ
- ```
- - π **Provider agnostic** β Claude, Gemini, Codex, OpenCode, Cursor Agent, Kilo, Kiro, Ollama, LM Studio, GitHub Models, MiniMax
- - π¦ **Pure Bash core** β no runtime framework; individual providers may require their own CLI or API tooling
- - πͺ **Git native** β Standard pre-commit hook
- - β‘ **Smart caching** β Skip unchanged files
- - π **PR review mode** β Review full PRs, not just last commit
- - πͺ **Cross-platform** β macOS, Linux, Windows (Git Bash), WSL
- ---
- ## π¦ Installation
- ### Homebrew (recommended)
- ```bash
- brew install gentleman-programming/tap/gga
- ```
- ### Manual
- ```bash
- git clone https://github.com/Gentleman-Programming/gentleman-guardian-angel.git
- cd gentleman-guardian-angel
- ./install.sh
- ```
- ### Windows (Git Bash, PowerShell, cmd.exe)
- ```bash
- git clone https://github.com/Gentleman-Programming/gentleman-guardian-angel.git
- cd gentleman-guardian-angel
- bash install.sh
- echo 'export PATH="$HOME/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc
- ```
- On Windows, the installer also creates `~/bin/gga.bat` so `gga` can be called from `cmd.exe` and PowerShell. Add `%USERPROFILE%\bin` to your Windows user `PATH` for those shells; `.bashrc` only affects Git Bash.
- > **WSL** is also fully supported β no special configuration needed.
- ### Oh My Zsh users
- If you use [Oh My Zsh](https://ohmyz.sh/) with the `git` plugin enabled (the default), the alias `gga` will conflict with this CLI. You'll see:
- ```
- git: 'gui' is not a git command. See 'git --help'.
- ```
- **Fix:** Add this line to your `~/.zshrc` after the Oh My Zsh source line:
- ```bash
- unalias gga 2>/dev/null
- ```
- Then run `source ~/.zshrc` or open a new terminal.
- ---
- ## π Quick Start
- ```bash
- cd ~/your-project
- gga init # Create .gga config
- gga install # Install git hook
- # Edit .gga to set your PROVIDER
- # Create AGENTS.md with your coding standards
- # Done β every commit gets reviewed π
- ```
- ---
- ## π Providers
- | Provider | Config Value | Installation |
- |----------|-------------|-------------|
- | **Claude** | `claude` | [claude.ai/code](https://claude.ai/code) |
- | **Gemini** | `gemini` | [gemini-cli](https://github.com/google-gemini/gemini-cli) |
- | **Codex** | `codex` | `npm i -g @openai/codex` |
- | **OpenCode** | `opencode` | [opencode.ai](https://opencode.ai) |
- | **Cursor Agent** | `cursor[:model]` | [cursor.com](https://cursor.com) |
- | **Kilo** | `kilo[:model]` | `npm install -g @kilocode/cli` |
- | **Kiro** | `kiro` | [kiro.dev/downloads](https://kiro.dev/downloads/) |
- | **Ollama** | `ollama:<model>` | [ollama.ai](https://ollama.ai) |
- | **LM Studio** | `lmstudio[:model]` | [lmstudio.ai](https://lmstudio.ai) |
- | **GitHub Models** | `github:<model>` | [marketplace/models](https://github.com/marketplace/models) |
- | **MiniMax** | `minimax[:model]` | [platform.minimax.io](https://platform.minimax.io) |
- > π See [docs/providers.md](docs/providers.md) for detailed examples and setup.
- ---
- ## π Commands
- | Command | Description |
- |---------|------------|
- | `gga init` | Create sample `.gga` config |
- | `gga install` | Install pre-commit hook |
- | `gga install --commit-msg` | Install commit-msg hook |
- | `gga uninstall` | Remove hooks |
- | `gga run` | Review staged files |
- | `gga run --ci` | Review last commit (CI/CD) |
- | `gga run --pr-mode` | Review full PR changes |
- | `gga run --no-cache` | Review ignoring cache |
- | `gga config` | Show configuration |
- | `gga cache status` | Show cache info |
- | `gga version` | Show version |
- > π See [docs/commands.md](docs/commands.md) for detailed usage.
- ---
- ## π Documentation
- | Topic | Description |
- |-------|------------|
- | [Configuration](docs/configuration.md) | `.gga` config file, options, hierarchy, env overrides |
- | [Rules File](docs/rules-file.md) | Writing effective `AGENTS.md`, best practices, skill-based approach |
- | [Providers](docs/providers.md) | Detailed setup for each AI provider |
- | [Commands](docs/commands.md) | Full command reference with examples |
- | [Caching](docs/caching.md) | How smart caching works, invalidation, commands |
- | [Integrations](docs/integrations.md) | Husky, pre-commit, Lefthook, VS Code, CI/CD |
- | [Examples](docs/examples.md) | Real-world walkthrough, project configs |
- | [Troubleshooting](docs/troubleshooting.md) | Common issues and fixes |
- | [Changelog](docs/changelog.md) | Version history |
- | [Contributing](CONTRIBUTING.md) | How to contribute (issue-first workflow) |
- ---
- ## π License
- MIT Β© 2024
- <p align="center">
- <sub>Built with π§ by developers who got tired of repeating the same code review comments</sub>
- </p>
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If itβs helped, pass it on.