Magicc NPM | npm.io

Magic Commit 🪄

You can do magicc, you can build anything that you desire. 🪄🔮💻

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! 🙏

😎 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

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.

🎯 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 and Support

Love what I do? Send me some love or coffee!? 💖☕
Can't send love or coffees? 😥 Nominate me for a GitHub Star instead! Your support will help me to continue working on open-source projects like this. 🙏😇