Git Genie — Usage Guide

Essence: gg automates staging, Conventional Commit creation, branch flow, optional merge to main, and push. It also includes secure API key storage and AI-powered branch/PR naming.

Quick start

Global install:

npm install -g @gunjanghate/git-genie

Configure your Gemini API key once:

gg config YOUR_GEMINI_API_KEY_HERE

Make a commit with AI assist:

gg "add user profile section" --type feat --scope ui --genie

Install & verify

which gg            # macOS / Linux
Get-Command gg      # PowerShell
gg --help           # Shows banner + onboarding instructions

Use ad-hoc without global install:

npx @gunjanghate/git-genie "fix typo" --genie

Configure Gemini API key

Priority order used by the CLI:

1. GEMINI_API_KEY environment variable
2. OS keychain where available
3. Encrypted fallback: ~/.gitgenie/config.json

Rotate keys any time with:

gg config <NEW_GEMINI_API_KEY>