Skip to content
Back to search

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/gentleman-programming--gentleman-guardian-angel/badge.svg)](/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

i

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)

  1. <p align="center">
  2. <img width="1024" height="408" alt="image" src="https://github.com/user-attachments/assets/e534ba1e-0044-45c7-a788-b455733c0052" />
  3. </p>
  4. <p align="center">
  5. <strong>Provider-agnostic code review using AI</strong><br>
  6. Use Claude, Gemini, Codex, OpenCode, Cursor Agent, Kilo, Kiro, Ollama, LM Studio, GitHub Models, MiniMax, or any AI to enforce your coding standards.<br>
  7. Pure Bash core. Works everywhere.
  8. </p>
  9. <p align="center">
  10. <img src="https://img.shields.io/badge/version-2.10.1-blue.svg" alt="Version">
  11. <img src="https://img.shields.io/badge/license-MIT-green.svg" alt="License">
  12. <img src="https://img.shields.io/badge/bash-5.0%2B-orange.svg" alt="Bash">
  13. <img src="https://img.shields.io/badge/platforms-macOS%20%7C%20Linux%20%7C%20Windows-lightgrey.svg" alt="Platforms">
  14. <img src="https://img.shields.io/badge/homebrew-tap-FBB040.svg" alt="Homebrew">
  15. <img src="https://img.shields.io/badge/tests-266%20passing-brightgreen.svg" alt="Tests">
  16. <img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg" alt="PRs Welcome">
  17. </p>
  18. <p align="center">
  19. <a href="#-installation">Installation</a> β€’
  20. <a href="#-quick-start">Quick Start</a> β€’
  21. <a href="#-providers">Providers</a> β€’
  22. <a href="#-commands">Commands</a> β€’
  23. <a href="#-documentation">Docs</a>
  24. </p>
  25. ---
  26. ## Example
  27. <img width="962" height="941" alt="image" src="https://github.com/user-attachments/assets/c8963dff-6aa5-420c-b58b-1416e81af384" />
  28. ## 🎯 Why?
  29. You have coding standards. Your team ignores them. Code reviews catch issues too late.
  30. **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.
  31. ```
  32. β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
  33. β”‚ git commit β”‚ ──▢ β”‚ AI Review β”‚ ──▢ β”‚ βœ… Pass/Fail β”‚
  34. β”‚ (staged files) β”‚ β”‚ (any LLM) β”‚ β”‚ (with details) β”‚
  35. β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
  36. ```
  37. - πŸ”Œ **Provider agnostic** β€” Claude, Gemini, Codex, OpenCode, Cursor Agent, Kilo, Kiro, Ollama, LM Studio, GitHub Models, MiniMax
  38. - πŸ“¦ **Pure Bash core** β€” no runtime framework; individual providers may require their own CLI or API tooling
  39. - πŸͺ **Git native** β€” Standard pre-commit hook
  40. - ⚑ **Smart caching** β€” Skip unchanged files
  41. - πŸ” **PR review mode** β€” Review full PRs, not just last commit
  42. - πŸͺŸ **Cross-platform** β€” macOS, Linux, Windows (Git Bash), WSL
  43. ---
  44. ## πŸ“¦ Installation
  45. ### Homebrew (recommended)
  46. ```bash
  47. brew install gentleman-programming/tap/gga
  48. ```
  49. ### Manual
  50. ```bash
  51. git clone https://github.com/Gentleman-Programming/gentleman-guardian-angel.git
  52. cd gentleman-guardian-angel
  53. ./install.sh
  54. ```
  55. ### Windows (Git Bash, PowerShell, cmd.exe)
  56. ```bash
  57. git clone https://github.com/Gentleman-Programming/gentleman-guardian-angel.git
  58. cd gentleman-guardian-angel
  59. bash install.sh
  60. echo 'export PATH="$HOME/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc
  61. ```
  62. 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.
  63. > **WSL** is also fully supported β€” no special configuration needed.
  64. ### Oh My Zsh users
  65. 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:
  66. ```
  67. git: 'gui' is not a git command. See 'git --help'.
  68. ```
  69. **Fix:** Add this line to your `~/.zshrc` after the Oh My Zsh source line:
  70. ```bash
  71. unalias gga 2>/dev/null
  72. ```
  73. Then run `source ~/.zshrc` or open a new terminal.
  74. ---
  75. ## πŸš€ Quick Start
  76. ```bash
  77. cd ~/your-project
  78. gga init # Create .gga config
  79. gga install # Install git hook
  80. # Edit .gga to set your PROVIDER
  81. # Create AGENTS.md with your coding standards
  82. # Done β€” every commit gets reviewed πŸŽ‰
  83. ```
  84. ---
  85. ## πŸ”Œ Providers
  86. | Provider | Config Value | Installation |
  87. |----------|-------------|-------------|
  88. | **Claude** | `claude` | [claude.ai/code](https://claude.ai/code) |
  89. | **Gemini** | `gemini` | [gemini-cli](https://github.com/google-gemini/gemini-cli) |
  90. | **Codex** | `codex` | `npm i -g @openai/codex` |
  91. | **OpenCode** | `opencode` | [opencode.ai](https://opencode.ai) |
  92. | **Cursor Agent** | `cursor[:model]` | [cursor.com](https://cursor.com) |
  93. | **Kilo** | `kilo[:model]` | `npm install -g @kilocode/cli` |
  94. | **Kiro** | `kiro` | [kiro.dev/downloads](https://kiro.dev/downloads/) |
  95. | **Ollama** | `ollama:<model>` | [ollama.ai](https://ollama.ai) |
  96. | **LM Studio** | `lmstudio[:model]` | [lmstudio.ai](https://lmstudio.ai) |
  97. | **GitHub Models** | `github:<model>` | [marketplace/models](https://github.com/marketplace/models) |
  98. | **MiniMax** | `minimax[:model]` | [platform.minimax.io](https://platform.minimax.io) |
  99. > πŸ“– See [docs/providers.md](docs/providers.md) for detailed examples and setup.
  100. ---
  101. ## πŸ“‹ Commands
  102. | Command | Description |
  103. |---------|------------|
  104. | `gga init` | Create sample `.gga` config |
  105. | `gga install` | Install pre-commit hook |
  106. | `gga install --commit-msg` | Install commit-msg hook |
  107. | `gga uninstall` | Remove hooks |
  108. | `gga run` | Review staged files |
  109. | `gga run --ci` | Review last commit (CI/CD) |
  110. | `gga run --pr-mode` | Review full PR changes |
  111. | `gga run --no-cache` | Review ignoring cache |
  112. | `gga config` | Show configuration |
  113. | `gga cache status` | Show cache info |
  114. | `gga version` | Show version |
  115. > πŸ“– See [docs/commands.md](docs/commands.md) for detailed usage.
  116. ---
  117. ## πŸ“š Documentation
  118. | Topic | Description |
  119. |-------|------------|
  120. | [Configuration](docs/configuration.md) | `.gga` config file, options, hierarchy, env overrides |
  121. | [Rules File](docs/rules-file.md) | Writing effective `AGENTS.md`, best practices, skill-based approach |
  122. | [Providers](docs/providers.md) | Detailed setup for each AI provider |
  123. | [Commands](docs/commands.md) | Full command reference with examples |
  124. | [Caching](docs/caching.md) | How smart caching works, invalidation, commands |
  125. | [Integrations](docs/integrations.md) | Husky, pre-commit, Lefthook, VS Code, CI/CD |
  126. | [Examples](docs/examples.md) | Real-world walkthrough, project configs |
  127. | [Troubleshooting](docs/troubleshooting.md) | Common issues and fixes |
  128. | [Changelog](docs/changelog.md) | Version history |
  129. | [Contributing](CONTRIBUTING.md) | How to contribute (issue-first workflow) |
  130. ---
  131. ## πŸ“„ License
  132. MIT Β© 2024
  133. <p align="center">
  134. <sub>Built with πŸ§‰ by developers who got tired of repeating the same code review comments</sub>
  135. </p>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.