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
Four steps with sensible defaults. Use flags to tailor your flow.
1
Step 1
Install
Install globally or in your project root.
npm install -g @gunjanghate/git-genie2
Step 2
Configure AI (once)
Stores the key in ~/.gitgenie/config.json so --genie can generate commits.
gg config YOUR_GEMINI_API_KEY3
Step 3
Commit with AI
Stages changes if needed, builds a Conventional Commit via Gemini, then commits.
gg "add user profile section" --type feat --scope ui --genie4
Step 4
Push / Merge
Accept prompts or auto-merge to main and push in one go.
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.