JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 17
  • Score
    100M100P100Q49494F
  • License MIT

AI-powered conventional commit message generator using Together.ai, smart CLI for easy, consistent git commits

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 🧠

npm version npm downloads license

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

  1. Stage your changes:
git add .
  1. Run Commit AMT:
npx commit-amt
  1. Review the AI-suggested commit message.

  2. 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

  1. Get your free API key from Together.ai.
  2. Create a .env file in your project root with:
TOGETHER_API_KEY=your_api_key_here
  1. Commit AMT will automatically use this API key.

📝 Example Output

🧠 Commit AMT - 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 AMT.

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:

  1. Fork the repo
  2. Create a new branch (git checkout -b feature-name)
  3. Commit your changes
  4. Push to the branch (git push origin feature-name)
  5. Open a pull request

📜 License

MIT © Abdullah Al Mubin