@suiz/ai-commit v4.2.0

SUIZ-AI-Commit: The Commit Message Generator

💻 Tired of writing boring commit messages? Let SUIZ-AI-Commit help!

This package leverages both local AI models through Ollama (primarily using Mistral) and OpenAI's GPT models to understand your code changes and generate meaningful commit messages for you. Running on your local machine with Ollama provides a free, private, and fast solution for generating commit messages. Whether you're working on a solo project or collaborating with a team, SUIZ-AI-Commit makes it easy to keep your commit history organized and informative.

How it Works

1. Install SUIZ-AI-Commit using npm install -g SUIZ-AI-Commit
2. Generate an OpenAI API key here
3. Set your OPENAI_API_KEY environment variable to your API key
4. Make your code changes and stage them with git add .
5. Type suiz-SUIZ-AI-Commit in your terminal
6. SUIZ-AI-Commit will analyze your changes and generate a commit message
7. Approve the commit message and SUIZ-AI-Commit will create the commit for you ✅

Using local model (ollama)

You can also use the local model for free with Ollama.

1. Install SUIZ-AI-Commit using npm install -g SUIZ-AI-Commit
2. Install Ollama from https://ollama.ai/
3. Run ollama run mistral to fetch model for the first time
4. Set PROVIDER=ollama in your environment
5. Make your code changes and stage them with git add .
6. Type suiz-SUIZ-AI-Commit in your terminal
7. SUIZ-AI-Commit will analyze your changes and generate a commit message
8. Approve the commit message and SUIZ-AI-Commit will create the commit for you ✅

Options

--list: Select from a list of 5 generated messages (or regenerate the list)

--force: Automatically create a commit without being prompted to select a message (can't be used with --list)

--filter-fee: Displays the approximate fee for using the API and prompts you to confirm the request

--apiKey: Your OpenAI API key. It is not recommended to pass apiKey here, it is better to use env variable

--emoji: Add a gitmoji to the commit message

--template: Specify a custom commit message template. e.g. --template "Modified {GIT_BRANCH} | {COMMIT_MESSAGE}"

--language: Specify the language to use for the commit message(default: english). e.g. --language english

--commit-type: Specify the type of commit to generate. This will be used as the type in the commit message e.g. --commit-type feat

Contributing

We'd love for you to contribute to SUIZ-AI-Commit! Here's how:

1. Fork the repository
2. Clone your fork to your local machine
3. Create a new branch
4. Make your changes
5. Commit your changes and push to your fork
6. Create a pull request to the SUIZ-AI-Commit repository

Roadmap

• Support for multimple suggestions: Provide multiple suggestions for the commit message.
• Support for custom commit types: Allow users to specify a custom commit type manually.
• Automated scope detection: Detect the scope of changes and automatically include it in the commit message.
• Improved emoji suggestions: Enhance the emoji suggestions generated by SUIZ-AI-Commit to better match the changes made to the code.
• Commit message templating: Provide a customizable commit message template for users to follow.
• Interactive commit message generation: Allow users to interact with SUIZ-AI-Commit during the commit message generation process to provide more context and refine the generated message.
• Integration with Git hooks: Integrate SUIZ-AI-Commit with Git hooks so that it can automatically generate commit messages whenever changes are staged.
• Advanced diff analysis: Enhance SUIZ-AI-Commit's diff analysis capabilities to better understand the changes made to the code.
• Reverse commit message generation: Allow users to generate code changes from a commit message.

License

SUIZ-AI-Commit is licensed under the MIT License.

Happy coding 🚀