Gemini CLI Git Helper

A comprehensive extension and skill for 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 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.

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.

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:

/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