{"id":15374379,"url":"https://github.com/warengonzaga/magic-commit","last_synced_at":"2025-04-15T15:11:23.730Z","repository":{"id":225876964,"uuid":"765648769","full_name":"warengonzaga/magic-commit","owner":"warengonzaga","description":"You can do magicc, you can build anything that you desire. 🪄🔮💻","archived":false,"fork":false,"pushed_at":"2024-10-19T17:02:31.000Z","size":3924,"stargazers_count":35,"open_issues_count":9,"forks_count":4,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-12T19:23:27.214Z","etag":null,"topics":["ai","ai-commit","aicommit","cli","commit","devtool","git","gpt","hacktoberfest","magic","openai","opencommit","terminal","tool"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/warengonzaga.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"contributing.md","funding":".github/funding.yml","license":"license","code_of_conduct":"code_of_conduct.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"security.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null},"funding":{"github":"warengonzaga","buy_me_a_coffee":"warengonzaga"}},"created_at":"2024-03-01T10:44:22.000Z","updated_at":"2025-02-10T08:14:31.000Z","dependencies_parsed_at":"2024-04-18T12:32:07.435Z","dependency_job_id":null,"html_url":"https://github.com/warengonzaga/magic-commit","commit_stats":{"total_commits":51,"total_committers":2,"mean_commits":25.5,"dds":"0.019607843137254943","last_synced_commit":"a106d0e55d525950e9ad5f120c87a695908860ad"},"previous_names":["warengonzaga/magic-commit"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/warengonzaga%2Fmagic-commit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/warengonzaga%2Fmagic-commit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/warengonzaga%2Fmagic-commit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/warengonzaga%2Fmagic-commit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/warengonzaga","download_url":"https://codeload.github.com/warengonzaga/magic-commit/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249094932,"owners_count":21211837,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","ai-commit","aicommit","cli","commit","devtool","git","gpt","hacktoberfest","magic","openai","opencommit","terminal","tool"],"created_at":"2024-10-01T13:58:29.449Z","updated_at":"2025-04-15T15:11:23.709Z","avatar_url":"https://github.com/warengonzaga.png","language":"JavaScript","funding_links":["https://github.com/sponsors/warengonzaga","https://buymeacoffee.com/warengonzaga","https://github.com/sponsors/warengonzaga)!","https://buymeacoffee.com/warengonzaga)!"],"categories":[],"sub_categories":[],"readme":"# Magic Commit 🪄 [![author/maintainer](https://img.shields.io/badge/by-Waren%20Gonzaga-016eea.svg?logo=github\u0026labelColor=181717\u0026longCache=true\u0026style=flat-square)](https://warengonzaga.com) [![nominate](https://img.shields.io/badge/nominate-%20@warengonzaga%20as%20GitHub%20Star-yellow.svg?logo=github\u0026labelColor=181717\u0026longCache=true\u0026style=flat-square)](https://stars.github.com/nominate)\n\n[![made with](https://img.shields.io/badge/made%20with-Open%20Source%20Software%20PH-0060a0.svg?logo=github\u0026longCache=true\u0026labelColor=181717\u0026style=flat-square)](https://github.com/ossphilippines) [![sponsors](https://img.shields.io/badge/sponsor-%E2%9D%A4-%23db61a2.svg?\u0026logo=github\u0026logoColor=white\u0026labelColor=181717\u0026style=flat-square)](https://github.com/sponsors/warengonzaga) [![release](https://img.shields.io/github/release/warengonzaga/magic-commit.svg?logo=github\u0026labelColor=181717\u0026color=green\u0026style=flat-square)](https://github.com/warengonzaga/magic-commit/releases) [![star](https://img.shields.io/github/stars/warengonzaga/magic-commit.svg?\u0026logo=github\u0026labelColor=181717\u0026color=yellow\u0026style=flat-square)](https://github.com/warengonzaga/magic-commit/stargazers) [![license](https://img.shields.io/github/license/warengonzaga/magic-commit.svg?\u0026logo=github\u0026labelColor=181717\u0026style=flat-square)](https://github.com/warengonzaga/magic-commit/blob/main/license) [![NPM Installs](https://img.shields.io/npm/dt/magicc?color=CB3837\u0026logo=npm\u0026label=installs\u0026labelColor=181717\u0026style=flat-square)](https://npmjs.com/package/magicc)\n\n[![banner](https://raw.githubusercontent.com/warengonzaga/magic-commit/main/.github/assets/repo_banner.jpg)](https://github.com/warengonzaga/magic-commit)\n\nYou can do `magicc`, you can build anything that you desire. 🪄🔮💻\n\n**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. 🪄\n\nHave suggestions in mind? [Let me know!](https://github.com/warengonzaga/magic-commit/issues)\n\n\u003e [!IMPORTANT]  \n\u003e This project is still in it's early stage so expect some bugs and issues. Please report any issues you encounter. Thank you! 🙏\n\nLike this project? **Leave a star**! ⭐⭐⭐⭐⭐\n\n## 😎 Demo\n\n[![demo](https://raw.githubusercontent.com/warengonzaga/magic-commit/main/.github/assets/demo.gif)](https://github.com/warengonzaga/magic-commit)\n\n## 🕹️ Usage\n\nSave all of your changes and after that run the following command:\n\n```bash\nmagicc\n```\n\nThis 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. 🪄\n\n\u003e [!NOTE]  \n\u003e To be able to make it work it requires API key from [OpenAI](https://openai.com) 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:\n\u003e\n\u003e ```bash\n\u003e magicc -s=\u003capi-key\u003e\n\u003e ```\n\u003e\n\u003e 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](mailto:opensource@warengonzaga.com).)_\n\n## 📦 Installation\n\nYou can install this project via `npm` or `yarn`.\n\n```bash\nnpm install -g magicc\n```\n\nor\n\n```bash\nyarn global add magicc\n```\n\n## 💖 Motivation\n\nI 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. 🙏\n\nThis project is inspired by the following projects:\n\n- [aicommits](https://github.com/Nutlope/aicommits) - A CLI that writes your git commit messages for you with AI.\n- [ai-commit](https://github.com/insulineru/ai-commit) - Make commits easier with ChatGPT, Gitmoji and Conventional Commits.\n- [opencommit](https://github.com/di-sukharev/opencommit) - About\nAuto-generate impressive commits with AI in 1 second.\n- [tgpt](https://github.com/aandrew-me/tgpt) - AI Chatbots in terminal without needing API keys.\n\n## ⚙️ Project Activity\n\n![activity](https://repobeats.axiom.co/api/embed/b89d4c52ac63656f8148143516edd0db0d85788d.svg \"Repobeats analytics image\")\n\n## 🎯 Contributing\n\nContributions 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!\n\nRead the project's [contributing guide](./contributing.md) for more info.\n\n## 🐛 Issues\n\nPlease report any issues and bugs by [creating a new issue here](https://github.com/warengonzaga/magic-commit/issues/new/choose), also make sure you're reporting an issue that doesn't exist. Any help to improve the project would be appreciated. Thanks! 🙏✨\n\n## 🙏 Sponsor\n\nLike this project? **Leave a star**! ⭐⭐⭐⭐⭐\n\nWant to support my work and get some perks? [Become a sponsor](https://github.com/sponsors/warengonzaga)! 💖\n\nOr, you just love what I do? [Buy me a coffee](https://buymeacoffee.com/warengonzaga)! ☕\n\nRecognized my open-source contributions? [Nominate me](https://stars.github.com/nominate) as GitHub Star! 💫\n\n## 📋 Code of Conduct\n\nRead the project's [code of conduct](./code_of_conduct.md).\n\n## 📃 License\n\nThis project is licensed under [GNU General Public License v3.0](https://opensource.org/licenses/GPL-3.0).\n\n## 📝 Author\n\nThis project is created by **[Waren Gonzaga](https://github.com/warengonzaga)**, with the help of awesome [contributors](https://github.com/warengonzaga/magic-commit/graphs/contributors).\n\n[![contributors](https://contrib.rocks/image?repo=warengonzaga/magic-commit)](https://github.com/warengonzaga/magic-commit/graphs/contributors)\n\n---\n\n💻 with ❤️ by [Waren Gonzaga](https://warengonzaga.com) and [Him](https://www.youtube.com/watch?v=HHrxS4diLew\u0026t=44s) 🙏\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwarengonzaga%2Fmagic-commit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwarengonzaga%2Fmagic-commit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwarengonzaga%2Fmagic-commit/lists"}