Package Exports
- commit-amt
- commit-amt/index.js
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (commit-amt) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
commit-amt 🧠
AI-powered conventional commit message generator using Together.ai's DeepSeek-V3 model.
Streamline your git workflow with smart, clear commit messages crafted by AI.
✨ Features
- 🤖 AI-generated conventional commit messages
- 📝 Analyzes your staged changes with
git diff --cached
- ✨ Uses Together.ai's DeepSeek-V3 for smart suggestions
- 🎨 Colorful CLI interface with emojis
- ✏️ Edit suggested commit messages before committing
- 🔑 Secure API key management via
.env
file - 🚫 Handles missing API keys and no staged changes gracefully
📦 Installation
Use without installing globally:
npx commit-amt
Or install globally:
npm install -g commit-amt
🚀 Basic Usage
- Stage your changes:
git add .
- Run Commit Genius:
npx commit-amt
Review the AI-suggested commit message.
Choose to:
- ✅ Use the suggested message as-is
- ✏️ Edit the message manually
- ❌ Cancel the commit
📌 How to Use
Auto mode (tries local → cloud → rules)
npx commit-amt
Force local mode
npx commit-amt--local
Force cloud mode
npx commit-amt--ai
🔧 Setup
- Get your free API key from Together.ai.
- Create a
.env
file in your project root with:
TOGETHER_API_KEY=your_api_key_here
- Commit Genius will automatically use this API key.
📝 Example Output
🧠 Commit Genius - AI-powered commit messages
🔍 Analyzing your changes...
✅ Suggested commit message:
feat(auth): add OAuth2 authentication support
What would you like to do with this message?
❯ ✅ Use this message
✏️ Edit this message
❌ Cancel commit
📝 Committing changes...
🎉 Successfully committed!
❓ FAQ
How do I get the Together.ai API key?
Sign up for free at Together.ai, generate your API key, and add it to your .env
.
What if I have no staged changes?
Stage your changes using git add <files>
before running Commit Genius.
Can I edit the suggested commit message?
Yes! You can choose to edit the AI-generated message before committing.
🤝 Contributing
Contributions, issues, and feature requests are welcome! Feel free to:
- Fork the repo
- Create a new branch (
git checkout -b feature-name
) - Commit your changes
- Push to the branch (
git push origin feature-name
) - Open a pull request
📜 License
MIT © Abdullah Al Mubin