Gentleman Guardian Angel – AI provider-agnostic code review via Git hook
a day ago
- #git-hooks
- #code-review
- #ai
- Gentleman Guardian Angel (GGA) is a provider-agnostic AI code review tool that enforces coding standards.
- It runs on every commit, validating staged files against project rules defined in AGENTS.md.
- Key features include zero dependencies (pure Bash), git-native integration, and smart caching.
- Supports multiple AI providers: Claude, Gemini, Codex, and Ollama.
- Highly configurable with file patterns, exclusions, and strict mode for CI/CD.
- Installation options include Homebrew and direct cloning from GitHub.
- Setup involves initializing config, creating AGENTS.md rules, and installing git hooks.
- Example workflow shows how it catches violations during commit and allows fixes.
- Includes commands for managing cache, configuration, and running reviews.
- Integrates with popular hook managers like Husky, pre-commit, and Lefthook.
- Can be used in CI pipelines for GitHub Actions and GitLab CI.
- Development includes comprehensive testing with ShellSpec and shellcheck linting.