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.
How it works
Three steps with clean defaults. Use flags to tailor your flow.
- 1
Install
Install Globally or Root of the project .
npm install -g @gunjanghate/git-genie - 2
Configure AI (once)
Saves key to ~/.gitgenie/config.json so --genie can generate commits.
gg config YOUR_GEMINI_API_KEY - 3
Commit with AI
Auto stages (if needed), builds Conventional Commit via Gemini, commits.
gg "add user profile section" --type feat --scope ui --genie - 4
Push / Merge
Either accept push prompts or auto merge to main & push in one go.
gg "finish oauth flow" --push-to-main
Watch 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.