git-iris
Health Pass
- License — License: Apache-2.0
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Community trust — 34 GitHub stars
Code Fail
- rm -rf — Recursive force deletion command in docker/test-image.sh
Permissions Pass
- Permissions — No dangerous permissions requested
This tool is an intelligent MCP server and CLI agent that analyzes your codebase to automatically generate detailed Git artifacts, such as commit messages, changelogs, and code reviews.
Security Assessment
To function, the application inherently requires access to your local source code and Git history to analyze changes. Because it acts as an AI agent, it makes outbound network requests to external Large Language Model (LLM) APIs to process this data. The automated scan noted a recursive force deletion command (`rm -rf`) inside a Docker test script. While this is standard practice for cleaning up test environments rather than a malicious payload, it is worth being aware of. No dangerous permissions or hardcoded secrets were detected. Overall risk rating: Medium (due to the necessity of sending code context to third-party AI APIs).
Quality Assessment
The project demonstrates strong health and maintenance indicators. It is written in Rust, providing excellent memory safety, and is licensed under the permissive Apache-2.0. The repository received its last update today, proving highly active development. Backed by 34 GitHub stars, the tool shows emerging community trust and offers professional CI/CD pipelines alongside comprehensive documentation.
Verdict
Use with caution — the tool itself is safe and well-maintained, but users must explicitly trust the external third-party AI provider they configure it with, as their source code will be transmitted over the network.
An intelligent agent that understands your code and crafts perfect Git artifacts
🔮 Git-Iris: Your Agentic Git Companion
✨ An intelligent agent that understands your code and crafts perfect Git artifacts ✨
📖 Documentation • Installation • Quick Start • Studio • GitHub Action • Contributing
Iris crafting commit messages, reviewing code, generating changelogs, and chatting about your changes
💜 Overview
Git-Iris is powered by Iris, an intelligent agent that actively explores your codebase to understand what you're building. Rather than dumping context and hoping for the best, Iris uses tools to gather precisely the information she needs—analyzing diffs, exploring file relationships, and building understanding iteratively.
🪄 What Iris Can Do
| Capability | Description |
|---|---|
| ✍️ Commit Messages | Context-aware messages that capture the essence of your changes |
| 🔬 Code Reviews | Multi-dimensional analysis covering security, performance, and best practices |
| 📜 Pull Requests | Comprehensive PR descriptions for branches or individual commits |
| 🗂️ Changelogs | Keep a Changelog format with intelligent categorization |
| 🎊 Release Notes | User-focused documentation highlighting impact and benefits |
| 🔭 Semantic Blame | Ask "why does this code exist?" and get real answers |
🌌 Iris Studio
Studio is a stunning terminal interface built with the SilkCircuit Neon design language that brings everything together. Press / to chat with Iris, ask her to refine your commit message or explain changes—she can update content directly through intelligent tool calls!
📦 Installation
Quick Install (Recommended)
curl -fsSL https://raw.githubusercontent.com/hyperb1iss/git-iris/main/install.sh | sh
Homebrew
brew tap hyperb1iss/tap
brew install git-iris
Cargo
cargo install git-iris
Docker
docker pull hyperb1iss/git-iris:latest
From Releases
Download pre-built binaries from GitHub Releases for Linux (x64/ARM64), macOS (ARM64), and Windows.
Then configure your AI provider. OpenAI is the default, and Anthropic and Google are equally supported:
git-iris config --provider openai --api-key YOUR_OPENAI_API_KEY
# or:
git-iris config --provider anthropic --api-key YOUR_ANTHROPIC_API_KEY
git-iris config --provider google --api-key YOUR_GOOGLE_API_KEY
Supports OpenAI, Anthropic, and Google. See the Configuration Guide for details.
🚀 Quick Start
🌌 Launch Studio
git-iris
That's it. Studio auto-detects your context and suggests the right mode.
💫 Generate Commit Messages
git add .
git-iris gen # Interactive mode
git-iris gen --print # Just print the message
git-iris gen -a # Auto-commit with generated message
🔬 Review Code
git-iris review # Review staged changes
git-iris review --from main --to feature # Compare branches
git-iris review --commit abc1234 # Review specific commit
🗂️ Generate Changelogs & Release Notes
git-iris changelog --from v1.0.0 --update # Update CHANGELOG.md
git-iris release-notes --from v1.0.0 # Generate release notes
📜 Pull Request Descriptions
git-iris pr --from main --to feature-branch
🤖 GitHub Action
Automate release notes and changelogs in your CI/CD:
- name: Generate release notes
uses: hyperb1iss/git-iris@v2
with:
from: v1.0.0
to: v1.1.0
provider: openai
api-key: ${{ secrets.OPENAI_API_KEY }}
output-file: RELEASE_NOTES.md
See the GitHub Action documentation for all options.
📚 Documentation
Full documentation is available at hyperb1iss.github.io/git-iris
- 🚀 Getting Started — Installation, configuration, quick start
- 🌌 Studio Guide — Master the TUI, modes, and chat
- 📖 CLI Reference — All commands and options
- 🏗️ Architecture — How Iris works under the hood
🤝 Contributing
We welcome contributions! Please see CONTRIBUTING.md for details.
⚖️ License
Distributed under the Apache 2.0 License. See LICENSE for more information.
📚 Documentation · 🐛 Report Bug · 💡 Request Feature
Created by Stefanie Jane 🌠
If you find Git-Iris useful, buy me a Monster Ultra Violet! ⚡️
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found