| Crates.io | git-iris |
| lib.rs | git-iris |
| version | 2.0.4 |
| created_at | 2024-08-25 06:55:03.702142+00 |
| updated_at | 2026-01-09 06:10:14.68153+00 |
| description | AI-powered Git workflow assistant for smart commits, code reviews, changelogs, and release notes |
| homepage | https://github.com/hyperb1iss/git-iris |
| repository | https://github.com/hyperb1iss/git-iris |
| max_upload_size | |
| id | 1350831 |
| size | 1,639,333 |
โจ 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
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.
| 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 |
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!
curl -fsSL https://raw.githubusercontent.com/hyperb1iss/git-iris/main/install.sh | sh
brew tap hyperb1iss/tap
brew install git-iris
cargo install git-iris
docker pull hyperb1iss/git-iris:latest
Download pre-built binaries from GitHub Releases for Linux (x64/ARM64), macOS (ARM64), and Windows.
Then configure your AI provider:
git-iris config --provider anthropic --api-key YOUR_API_KEY
Supports OpenAI, Anthropic, and Google. See the Configuration Guide for details.
git-iris
That's it. Studio auto-detects your context and suggests the right mode.
git add .
git-iris gen # Interactive mode
git-iris gen --print # Just print the message
git-iris gen -a # Auto-commit with generated message
git-iris review # Review staged changes
git-iris review --from main --to feature # Compare branches
git-iris review --commit abc1234 # Review specific commit
git-iris changelog --from v1.0.0 --update # Update CHANGELOG.md
git-iris release-notes --from v1.0.0 # Generate release notes
git-iris pr --from main --to feature-branch
Automate release notes and changelogs in your CI/CD:
- name: Generate release notes
uses: hyperb1iss/git-iris@v1
with:
from: v1.0.0
to: v1.1.0
api-key: ${{ secrets.OPENAI_API_KEY }}
output-file: RELEASE_NOTES.md
See the GitHub Action documentation for all options.
Full documentation is available at hyperb1iss.github.io/git-iris
We welcome contributions! Please see CONTRIBUTING.md for details.
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! โก๏ธ