Back to the catalog

git-helper

Git helper for commits and reviews

Open source Open in the app JSON README (API)

About

Git helper for commits and reviews

Details

Kind
Plugins
Topic
Version control
Publisher
a-k-6
Origin
gemini
Category
ferramentas
Version
0.1.1
Stars
2
Last push
2026-03-20T01:48:06Z
Repository state
ativo
Added
2026-08-30 14:13:39
Updated
2026-08-30 14:13:39
Origin id
a-k-6/geminicli-git-helper

README

# Gemini CLI Git Helper

A comprehensive extension and skill for [Gemini CLI](https://github.com/google/gemini-cli) designed to streamline Git workflows. It automates semantic commit message generation and provides deep code reviews using native Git commands.

## Features

- **Semantic Commit Generator (`/gh.commit`)**:
  - Automatically analyzes staged changes (`git diff --staged`).
  - Generates commit messages following the [Conventional Commits](https://www.conventionalcommits.org/) specification.
  - Requires explicit user approval before executing the commit.
- **Deep Code Review (`/gh.review`)**:
  - Reviews changes between branches or specific commits.
  - Identifies logic bugs, security vulnerabilities, and performance bottlenecks.
  - Provides actionable code suggestions in diff format.
- **Smart Staging (`/gh.add`)**:
  - Interactively steps through and stages changes.
- **Pull Request Assistant (`/gh.pr`)**:
  - Summarizes changes and generates a Pull Request draft.
- **Changelog Generator (`/gh.changelog`)**:
  - Generates a categorized changelog from recent semantic commits.
- **Undo/Revert Helper (`/gh.undo`)**:
  - Safely helps you undo or revert the last Git action.
- **Smart Synchronizer (`/gh.sync`)**:
  - Fetches updates and analyzes potential conflicts before merging or rebasing.
- **History Polisher (`/gh.fixup`)**:
  - Identifies 'fixup!' commits and offers to automatically squash them using interactive rebase.
- **Bug Hunter (`/gh.bisect`)**:
  - Guides the user through git bisect to find the commit that introduced a bug.
- **Context Switcher (`/gh.worktree`)**:
  - Manages Git worktrees for easy context switching without stashing.
- **Narrative Blame (`/gh.explain`)**:
  - Explains the 'why' behind a change by analyzing commit history and context.
- **Workflow Skill**:
  - Enhances the agent's native understanding of Git procedures.
  - Triggers on natural language requests like "Review my changes" or "Help me commit this."

## Installation

### 1. Install the Skill
The skill provides the procedural knowledge for the agent to handle Git tasks effectively.
```bash
gemini skills install https://github.com/A-K-6/geminicli-git-helper
```

### 2. Install the Extension
The extension adds specific commands like `/gh.commit`, `/gh.review`, `/gh.add`, `/gh.pr`, `/gh.changelog`, and `/gh.undo` to your CLI.
```bash
gemini extensions install https://github.com/A-K-6/geminicli-git-helper
```

### 3. Reload
If you are already in an interactive Gemini CLI session, reload to enable the new features:
```bash
/skills reload
/extensions reload
```

## Gallery & Discoverability

To make this extension and skill discoverable in the Gemini CLI gallery, ensure the following topics are added to your GitHub repository:
- `gemini-extension`
- `gemini-skill`

## Development

- `PRD.md`: Project Requirements Document.
- `devlog.md`: Development history and progress.
- `gemini-extension.json`: Extension manifest.
- `GEMINI.md`: Extension context/playbook.
- `SKILL.md`: Skill definition and workflow.
- `commands/`: Custom slash commands.

## License
MIT

More