Back to the catalog

commitzen

A Gemini CLI extension to generate high-quality Git commit messages following the Conventional Commits v1.0.0 specification.

Open source Open in the app JSON README (API)

About

A Gemini CLI extension to generate high-quality Git commit messages following the Conventional Commits v1.0.0 specification.

Details

Kind
Plugins
Topic
Version control
Publisher
fiquellcarter
Origin
gemini
Category
ferramentas
Version
0.1.0
Stars
1
Last push
2026-01-14T20:24:00Z
Repository state
ativo
License
Apache-2.0
Added
2026-08-30 14:13:39
Updated
2026-08-30 14:13:39
Origin id
fiquellcarter/commitzen

README

# Gemini CLI Commitzen Extension

The Commitzen extension is an open-source Gemini CLI extension built to automate and standardize your Git commit history. This extension adds a powerful new command to Gemini CLI that analyzes your staged changes and generates high-quality commit messages following the [Conventional Commits v1.0.0](https://www.conventionalcommits.org/) specification.

## Features

- **Semantic Analysis**: Automatically identifies the correct type (feat, fix, refactor, etc.) based on code intent.
- **Smart Scoping**: Infers the scope of changes from your project's directory structure.
- **Breaking Change Detection**: Automatically flags breaking changes with the `!` suffix and required footer.
- **Clean Output**: Generates raw text ready to be piped directly into your git commands.

## Installation

Install the Commitzen extension by running the following command from your terminal _(requires Gemini CLI v0.4.0 or newer)_:

```bash
gemini extensions install https://github.com/fiquellcarter/commitzen
```

If you do not yet have Gemini CLI installed, or if the installed version is older than 0.4.0, see the [Gemini CLI installation instructions](https://github.com/google-gemini/gemini-cli?tab=readme-ov-file#-installation).

## Use the extension

The Commitzen extension adds the `/commitzen` command to Gemini CLI which analyzes staged git changes to generate a structured commit message.

## Resources

- [Gemini CLI extensions](https://github.com/google-gemini/gemini-cli/blob/main/docs/extensions/index.md): Documentation about using extensions in Gemini CLI.
- [Conventional Commits](https://www.conventionalcommits.org/): The specification followed by this extension.
- [GitHub Issues](https://github.com/fiquellcarter/commitzen/issues): Report bugs or request new commit types.

## Legal

- License: [Apache License 2.0](https://github.com/fiquellcarter/commitzen/blob/main/LICENSE)

More