@arshad657/gitcommit-ai
v1.0.6
Published
An AI-powered Git commit message generator CLI tool.
Readme
GitCommit AI
AI-powered Git commit message generator for developers.
Generate meaningful commit messages directly from your staged Git changes and automatically create commits using your own API key.
Features
- 🤖 AI-generated commit messages
- 📝 Conventional Commit support
- 🚀 Automatic Git commits
- 📄 Optional commit descriptions
- 🔑 Bring Your Own API Key
- ⚡ Fast CLI experience
- 🌍 Cross-platform support
- 🔒 Privacy-focused
- 🛠 Open source
Installation
Global Installation
npm install -g @arshad657/gitcommit-aiVerify Installation
gitcommit --versionQuick Start
1. Initialize GitCommit AI
gitcommit initYou will be prompted to enter your API key.
2. Stage Your Changes
git add .3. Generate and Commit
gitcommitExample output:
✦ Generated: feat(auth): implement GitHub OAuth login
─────────────────────────────────────────
Commit with this message? [Y/n]You can confirm with y, yes, or by pressing Enter.
Commands
Generate Commit and Prompt for Confirmation
gitcommitGenerate Commit With Description
gitcommit --bodyExample:
feat(auth): implement GitHub OAuth login
- Added GitHub OAuth flow
- Added callback handling
- Added token persistenceSkip Confirmation Prompt (Automatic Commit)
gitcommit --auto
# or
gitcommit --yesReconfigure API Key
gitcommit initExample Workflow
git add .
gitcommit --bodyOutput:
feat(user): add profile image upload
- Added image upload endpoint
- Added file validation
- Updated profile settings UIOnce confirmed, GitCommit AI will execute:
git commit -m "feat(user): add profile image upload" -m "Added image upload endpoint..."Why GitCommit AI?
Writing commit messages is repetitive.
GitCommit AI analyzes your staged changes and generates concise, meaningful commit messages following modern Git conventions.
Focus on building products instead of thinking about commit wording.
Privacy
GitCommit AI:
- Does not store source code
- Does not collect analytics
- Does not track users
- Uses your own API key
- Processes only the staged Git diff required to generate commit messages
Roadmap
v1
- CLI commit generation
- Automatic commit creation
- Commit descriptions
v2
- Documentation website
- Interactive onboarding
v3
- VS Code Extension
v4
- Team collaboration features
Contributing
Contributions are welcome.
git clone https://github.com/@arshad657/gitcommit-ai/@arshad657/gitcommit-ai.gitCreate a feature branch:
git checkout -b feature/amazing-featureCommit your changes:
git commit -m "feat: add amazing feature"Push your branch:
git push origin feature/amazing-featureOpen a Pull Request.
License
MIT License
Made for developers who prefer coding over writing commit messages.
