magicc
v0.2.6
Published
You can do `magicc`, you can build anything that you desire.
Downloads
23
Maintainers
Readme
Magic Commit 🪄
You can do magicc
, you can build anything that you desire. 🪄🔮💻
Magic Commit is a simple and easy-to-use tool that helps you to automatically stage your changes by file and commit them one by one. All you need to do is type magicc
and accept if you love the suggested commit message in every changed files. It uses gpt-4o-mini
as the default model from OpenAI to generate commit messages. 🪄
Have suggestions in mind? Let me know!
[!IMPORTANT]
This project is still in it's early stage so expect some bugs and issues. Please report any issues you encounter. Thank you! 🙏
Like this project? Leave a star! ⭐⭐⭐⭐⭐
😎 Demo
🕹️ Usage
Save all of your changes and after that run the following command:
magicc
This will automatically stage your changes by file and commit them one by one. All you need to do is type magicc
and accept if you love the suggested commit message in every changed files. 🪄
[!NOTE]
To be able to make it work it requires API key from OpenAI to use the GPT-3 model. You can get your API key by signing up to their website. Once you have the API key, you can set it up by running the following command:magicc -s=<api-key>
This will save your API key to the configuration file and you can now use the
magicc
command. I'm considering to find a provider that offers free API key for this project. 🙏 (if you are reading this contact me.)
📦 Installation
You can install this project via npm
or yarn
.
npm install -g magicc
or
yarn global add magicc
💖 Motivation
I created this project because I wanted a simple and easy-to-use tool that follows my own git commit standard by default. Additionally, I wanted to learn how to build AI-based developer tools. The goal of this project is to provide a user-friendly experience for everyone. If you're looking for more advanced features, I recommend checking out the other projects mentioned below. 🙏
This project is inspired by the following projects:
- aicommits - A CLI that writes your git commit messages for you with AI.
- ai-commit - Make commits easier with ChatGPT, Gitmoji and Conventional Commits.
- opencommit - About Auto-generate impressive commits with AI in 1 second.
- tgpt - AI Chatbots in terminal without needing API keys.
⚙️ Project Activity
🎯 Contributing
Contributions are welcome, create a pull request to this repo and I will review your code. Please consider to submit your pull request to the dev
branch. Thank you!
Read the project's contributing guide for more info.
🐛 Issues
Please report any issues and bugs by creating a new issue here, also make sure you're reporting an issue that doesn't exist. Any help to improve the project would be appreciated. Thanks! 🙏✨
🙏 Sponsor
Like this project? Leave a star! ⭐⭐⭐⭐⭐
Want to support my work and get some perks? Become a sponsor! 💖
Or, you just love what I do? Buy me a coffee! ☕
Recognized my open-source contributions? Nominate me as GitHub Star! 💫
📋 Code of Conduct
Read the project's code of conduct.
📃 License
This project is licensed under GNU General Public License v3.0.
📝 Author
This project is created by Waren Gonzaga, with the help of awesome contributors.
💻 with ❤️ by Waren Gonzaga and Him 🙏