origins
with just one command.
Your own Github Genie | 3k+ downloads
Meet GitGenie 
with just one command.
npm i @gunjanghate/git-genie 🔮 GitGenie 🔮
┌─────────────────┐
│ ✨ AI-Powered Git ✨ │
│ Smart Commit Magic │
└─────────────────┘
⚡ Ready to code! ⚡
$$$$$$\ $$$$$$\
$$ __$$\ $$ __$$\
$$ / \__|$$ / \__|
$$ |$$$$\ $$ |$$$$\
$$ | \_$$ |$$ |\_$$ |
$$ | $$ |$$ | $$ |
\$$$$$$ |\$$$$$$ |
\______/ \______/
Features
One command.
Stage, commit, push, and merge in one go.
AI commit messages.
Uses AI (Gemini) for Conventional Commits.
Custom flags.
Control with --genie, --staged, and more.
New Add OnsNEW
gg split
Intelligently split mixed changes into clean, logical commits.
- AI-powered grouping (opt-in)
- Heuristic fallback
- Interactive review flow
How it works
Just 4 steps to streamline your commit workflow. From installation to pushing production-ready commits, Git Genie handles the heavy lifting with AI-powered Conventional Commits.
Step 1Easy Setup
Install
Get started by installing Git Genie globally or locally in your project. One command is all you need.
npm install -g @gunjanghate/git-genieStep 2Secure Config
Configure AI (once)
Add your Gemini API key once. It's stored securely in ~/.gitgenie/config.json for future use.
gg config YOUR_GEMINI_API_KEYStep 3AI-Powered
Commit with AI
Describe your changes naturally. Git Genie generates Conventional Commits using AI in seconds.
gg "add user profile section" --type feat --scope ui --genieStep 4One-Click Deploy
Push / Merge
Finalize and push to your branch or auto-merge to main. Streamline your entire workflow.
gg "finish oauth flow" --push-to-mainWatch a quick demo
See how to stage, generate a Conventional Commit with AI, and push in one command.
Usage & Flags
Configure Git Genie behavior with clean, human-friendly flags.
Branch Management Shortcuts
Manage your branches effortlessly with these shortcuts.
gg b <branch>Create and switch to a new branch.
git checkout -b
git checkout -b
gg b feature/login
gg s <branch>Switch to an existing branch.
git checkout
git checkout
gg s main
gg wt ...Create a worktree for a branch.
Auto-creates branch if missing.
Auto-creates branch if missing.
gg wt docs ./docs
Frequently asked questions
Everything you need to know about GitGenie.
Join the community.
Contribute to Git Genie's development, share feedback, and connect with fellow developers.
Contribute
Help improve Git Genie by contributing code, documentation, or translations.
Feedback
Share your ideas, feature requests, and help shape the future of Git Genie.
Support
Get help from the community and help others with their Git workflows.