Back to the catalog

git-conventional-commits

Git workflow manager enforcing conventional commits and proper feature branching.

Open source Open in the app JSON README (API)

About

Git workflow manager enforcing conventional commits and proper feature branching.

Details

Kind
Plugins
Topic
Version control
Publisher
jorelcb
Origin
gemini
Category
ferramentas
Version
1.2.0
Forks
1
Last push
2026-02-15T23:51:15Z
Repository state
ativo
License
Apache-2.0
Added
2026-08-30 14:13:39
Updated
2026-08-30 14:13:39
Origin id
jorelcb/git-conventional-commits

README

# Git Conventional Commits Extension

> A **Pure Gemini Extension** (No-Code) that enforces [Conventional Commits](https://www.conventionalcommits.org/).

This extension empowers Gemini to act as a **Senior Git Workflow Expert**, guiding you through creating semantic commits and standardizing feature branches using your system's `git` directly.

## ✨ Features
- **Prompt-Based Logic**: Uses the official spec as ground truth for LLM reasoning.
- **Zero Dependencies**: No Node.js, Python, or compiled binaries required.
- **System Git**: Executes `!git` commands directly in your shell.
- **🧠 Context Evaluation**: Analyzes staged changes to suggest semantic messages.
- **🤝 Interactive Staging**: Smartly groups unstaged files when the staging area is empty.
- **🚀 Smart Push**: Automatically handles upstream branches.
- **🎨 Beautiful Logs**: Visualizes project history with a colorful graph.

## 🚀 Quick Start

### Install as Gemini Extension (Recommended)

Transform your terminal into an intelligent git assistant:

```bash
gemini extensions install https://github.com/jorelcb/git-conventional-commits
```

**🔄 Updating**:
```bash
gemini extensions install https://github.com/jorelcb/git-conventional-commits
```

### Available Slash Commands

| Command | Description |
|---------|-------------|
| `/git:commit` | 📝 Interactively stage (smart grouping) and commit with a valid message. |
| `/git:push` | 🚀 Push changes to remote (auto-sets upstream). |
| `/git:log` | 📜 View project history in a beautiful graph. |
| `/git:feature:start` | 🌿 Start a new feature branch (e.g., `feature/awesome-logic`). |
| `/git:feature:finish` | 🏁 Finish the current feature (Rebase + Push). |

**Part of the [Gemini Extensions Monorepo](../README.md)**

More