https://github.com/insulineru/ai-commit

✨ Make commits easier with ChatGPT, Gitmoji and Conventional Commits 🚀
https://github.com/insulineru/ai-commit

Last synced: 3 months ago
JSON representation

✨ Make commits easier with ChatGPT, Gitmoji and Conventional Commits 🚀

• Host: GitHub
• URL: https://github.com/insulineru/ai-commit
• Owner: insulineru
• Created: 2023-02-12T13:35:27.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2024-09-25T08:30:32.000Z (5 months ago)
• Last Synced: 2024-10-30T07:59:45.287Z (3 months ago)
• Language: JavaScript
• Homepage:
• Size: 42 KB
• Stars: 283
• Watchers: 2
• Forks: 39
• Open Issues: 12
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-ChatGPT-repositories - ai-commit - ✨ Make commits easier with ChatGPT, Gitmoji and Conventional Commits 🚀 (Others)

README

        




# **AI-Commit: The Commit Message Generator**

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

This package uses the power of OpenAI's GPT-3 model to understand your code changes and generate meaningful commit messages for you. Whether you're working on a solo project or collaborating with a team, AI-Commit makes it easy to keep your commit history organized and informative.

## Demo

![ai_commit_demo(1)(2)](https://github.com/JinoArch/ai-commit/assets/39610834/3002dfa2-737a-44b9-91c9-b43907f11144)

## How it Works

1. Install AI-Commit using `npm install -g ai-commit`

2. Generate an OpenAI API key [here](https://platform.openai.com/account/api-keys )

3. Set your `OPENAI_API_KEY` environment variable to your API key

1. Make your code changes and stage them with `git add .`

2. Type `ai-commit` in your terminal

3. AI-Commit will analyze your changes and generate a commit message

4. Approve the commit message and 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 AI-Commit using `npm install -g ai-commit`

2. Install Ollama from https://ollama.ai/

3. Run `ollama run mistral` to fetch model for the first time

4. Set `PROVIDER` in your environment to `ollama`

1. Make your code changes and stage them with `git add .`

2. Type `ai-commit` in your terminal

3. AI-Commit will analyze your changes and generate a commit message

4. Approve the commit message and 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 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 AI-Commit repository

## Roadmap

- [x] Support for multimple suggestions: Provide multiple suggestions for the commit message.

- [x] 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 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 AI-Commit during the commit message generation process to provide more context and refine the generated message.

- [ ] Integration with Git hooks: Integrate AI-Commit with Git hooks so that it can automatically generate commit messages whenever changes are staged.

- [ ] Advanced diff analysis: Enhance 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

AI-Commit is licensed under the MIT License.

## Happy coding 🚀