{"id":19713752,"url":"https://github.com/hyperb1iss/git-iris","last_synced_at":"2026-03-02T22:21:47.638Z","repository":{"id":250620858,"uuid":"834947056","full_name":"hyperb1iss/git-iris","owner":"hyperb1iss","description":"Accelerate your Git workflow with AI","archived":false,"fork":false,"pushed_at":"2024-09-24T05:23:57.000Z","size":2567,"stargazers_count":4,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-10-31T11:51:35.557Z","etag":null,"topics":["ai","cli","commit","generator","git","gitmoji","interactive","llm","rust"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hyperb1iss.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-07-28T19:33:52.000Z","updated_at":"2024-09-24T05:23:58.000Z","dependencies_parsed_at":"2024-08-07T07:56:32.344Z","dependency_job_id":"49d78433-2c5b-410f-87e6-0ceefa4ec6e0","html_url":"https://github.com/hyperb1iss/git-iris","commit_stats":null,"previous_names":["hyperb1iss/git-iris"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperb1iss%2Fgit-iris","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperb1iss%2Fgit-iris/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperb1iss%2Fgit-iris/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperb1iss%2Fgit-iris/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hyperb1iss","download_url":"https://codeload.github.com/hyperb1iss/git-iris/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224183959,"owners_count":17269762,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","cli","commit","generator","git","gitmoji","interactive","llm","rust"],"created_at":"2024-11-11T22:24:44.430Z","updated_at":"2026-03-02T22:21:47.631Z","avatar_url":"https://github.com/hyperb1iss.png","language":"Rust","readme":"# 🔮 Git-Iris: Your Agentic Git Companion\n\n\u003cdiv align=\"center\"\u003e\n\n[![CI/CD](https://img.shields.io/github/actions/workflow/status/hyperb1iss/git-iris/cicd.yml?style=for-the-badge\u0026logo=github-actions\u0026logoColor=white\u0026color=4C566A)](https://github.com/hyperb1iss/git-iris/actions)\n[![Docker](https://img.shields.io/docker/pulls/hyperb1iss/git-iris?style=for-the-badge\u0026logo=docker\u0026logoColor=white\u0026color=2496ED)](https://hub.docker.com/r/hyperb1iss/git-iris)\n[![License](https://img.shields.io/badge/License-Apache%202.0-5E81AC?style=for-the-badge\u0026logo=apache\u0026logoColor=white\u0026color=3B6EA8)](https://opensource.org/licenses/Apache-2.0)\n[![GitHub Release](https://img.shields.io/github/release/hyperb1iss/git-iris.svg?style=for-the-badge\u0026logo=github\u0026logoColor=white\u0026color=9D6DB3)][releases]\n[![Crates.io](https://img.shields.io/crates/v/git-iris.svg?style=for-the-badge\u0026logo=rust\u0026logoColor=white\u0026color=D35D47)][crates]\n[![GitHub Action](https://img.shields.io/badge/GitHub_Action-Available-5E81AC?style=for-the-badge\u0026logo=github-actions\u0026logoColor=white)](https://github.com/marketplace/actions/git-iris)\n[![Rust](https://img.shields.io/badge/rust-stable-EBCB8B?style=for-the-badge\u0026logo=rust\u0026logoColor=white\u0026color=EFBB4D)](https://www.rust-lang.org/)\n[![ko-fi](https://img.shields.io/badge/Ko--fi-Support%20Me-A3BE8C?style=for-the-badge\u0026logo=ko-fi\u0026logoColor=white\u0026color=82B062)](https://ko-fi.com/hyperb1iss)\n\n✨ _An intelligent agent that understands your code and crafts perfect Git artifacts_ ✨\n\n📖 [Documentation](https://hyperb1iss.github.io/git-iris/) • [Installation](#-installation) • [Quick Start](#-quick-start) • [Studio](#-iris-studio) • [GitHub Action](#-github-action) • [Contributing](#-contributing)\n\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/hyperb1iss/git-iris/main/docs/images/git-iris-screenshot-1.png\" alt=\"Commit Mode\" width=\"24%\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/hyperb1iss/git-iris/main/docs/images/git-iris-screenshot-2.png\" alt=\"Code Review\" width=\"24%\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/hyperb1iss/git-iris/main/docs/images/git-iris-screenshot-3.png\" alt=\"Changelog\" width=\"24%\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/hyperb1iss/git-iris/main/docs/images/git-iris-screenshot-4.png\" alt=\"Chat with Iris\" width=\"24%\"\u003e\n\u003c/div\u003e\n\n\u003cp align=\"center\"\u003e\u003cem\u003eIris crafting commit messages, reviewing code, generating changelogs, and chatting about your changes\u003c/em\u003e\u003c/p\u003e\n\n## 💜 Overview\n\nGit-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.\n\n### 🪄 What Iris Can Do\n\n| Capability             | Description                                                                   |\n| ---------------------- | ----------------------------------------------------------------------------- |\n| ✍️ **Commit Messages** | Context-aware messages that capture the essence of your changes               |\n| 🔬 **Code Reviews**    | Multi-dimensional analysis covering security, performance, and best practices |\n| 📜 **Pull Requests**   | Comprehensive PR descriptions for branches or individual commits              |\n| 🗂️ **Changelogs**      | Keep a Changelog format with intelligent categorization                       |\n| 🎊 **Release Notes**   | User-focused documentation highlighting impact and benefits                   |\n| 🔭 **Semantic Blame**  | Ask \"why does this code exist?\" and get real answers                          |\n\n### 🌌 Iris Studio\n\n**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!\n\n## 📦 Installation\n\n### Quick Install (Recommended)\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/hyperb1iss/git-iris/main/install.sh | sh\n```\n\n### Homebrew\n\n```bash\nbrew tap hyperb1iss/tap\nbrew install git-iris\n```\n\n### Cargo\n\n```bash\ncargo install git-iris\n```\n\n### Docker\n\n```bash\ndocker pull hyperb1iss/git-iris:latest\n```\n\n### From Releases\n\nDownload pre-built binaries from [GitHub Releases][releases] for Linux (x64/ARM64), macOS (ARM64), and Windows.\n\n---\n\nThen configure your AI provider:\n\n```bash\ngit-iris config --provider anthropic --api-key YOUR_API_KEY\n```\n\nSupports **OpenAI**, **Anthropic**, and **Google**. See the [Configuration Guide](https://hyperb1iss.github.io/git-iris/getting-started/configuration) for details.\n\n## 🚀 Quick Start\n\n### 🌌 Launch Studio\n\n```bash\ngit-iris\n```\n\nThat's it. Studio auto-detects your context and suggests the right mode.\n\n### 💫 Generate Commit Messages\n\n```bash\ngit add .\ngit-iris gen              # Interactive mode\ngit-iris gen --print      # Just print the message\ngit-iris gen -a           # Auto-commit with generated message\n```\n\n### 🔬 Review Code\n\n```bash\ngit-iris review                              # Review staged changes\ngit-iris review --from main --to feature     # Compare branches\ngit-iris review --commit abc1234             # Review specific commit\n```\n\n### 🗂️ Generate Changelogs \u0026 Release Notes\n\n```bash\ngit-iris changelog --from v1.0.0 --update    # Update CHANGELOG.md\ngit-iris release-notes --from v1.0.0         # Generate release notes\n```\n\n### 📜 Pull Request Descriptions\n\n```bash\ngit-iris pr --from main --to feature-branch\n```\n\n## 🤖 GitHub Action\n\nAutomate release notes and changelogs in your CI/CD:\n\n```yaml\n- name: Generate release notes\n  uses: hyperb1iss/git-iris@v1\n  with:\n    from: v1.0.0\n    to: v1.1.0\n    api-key: ${{ secrets.OPENAI_API_KEY }}\n    output-file: RELEASE_NOTES.md\n```\n\nSee the [GitHub Action documentation](https://hyperb1iss.github.io/git-iris/reference/github-action) for all options.\n\n## 📚 Documentation\n\nFull documentation is available at **[hyperb1iss.github.io/git-iris](https://hyperb1iss.github.io/git-iris/)**\n\n- 🚀 [Getting Started](https://hyperb1iss.github.io/git-iris/getting-started/) — Installation, configuration, quick start\n- 🌌 [Studio Guide](https://hyperb1iss.github.io/git-iris/studio/) — Master the TUI, modes, and chat\n- 📖 [CLI Reference](https://hyperb1iss.github.io/git-iris/reference/cli) — All commands and options\n- 🏗️ [Architecture](https://hyperb1iss.github.io/git-iris/architecture/) — How Iris works under the hood\n\n## 🤝 Contributing\n\nWe welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.\n\n## ⚖️ License\n\nDistributed under the Apache 2.0 License. See `LICENSE` for more information.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n📚 [Documentation](https://hyperb1iss.github.io/git-iris/) · 🐛 [Report Bug](https://github.com/hyperb1iss/git-iris/issues) · 💡 [Request Feature](https://github.com/hyperb1iss/git-iris/issues)\n\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n\nCreated by [Stefanie Jane 🌠](https://github.com/hyperb1iss)\n\nIf you find Git-Iris useful, [buy me a Monster Ultra Violet](https://ko-fi.com/hyperb1iss)! ⚡️\n\n\u003c/div\u003e\n\n[crates]: https://crates.io/crates/git-iris\n[releases]: https://github.com/hyperb1iss/git-iris/releases\n","funding_links":["https://ko-fi.com/hyperb1iss","https://ko-fi.com/hyperb1iss)!"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhyperb1iss%2Fgit-iris","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhyperb1iss%2Fgit-iris","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhyperb1iss%2Fgit-iris/lists"}