Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/undertone0809/gcop
🚀 AI-Powered Git Commit Assistant | Automate Commit Messages, Streamline Git Workflow. Help you write better git commit message.
https://github.com/undertone0809/gcop
commit-message git llm openai
Last synced: 6 days ago
JSON representation
🚀 AI-Powered Git Commit Assistant | Automate Commit Messages, Streamline Git Workflow. Help you write better git commit message.
- Host: GitHub
- URL: https://github.com/undertone0809/gcop
- Owner: Undertone0809
- License: mit
- Created: 2024-06-20T13:30:19.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2024-12-20T02:45:25.000Z (19 days ago)
- Last Synced: 2024-12-26T00:30:36.368Z (13 days ago)
- Topics: commit-message, git, llm, openai
- Language: Python
- Homepage: https://gcop.zeeland.top
- Size: 2.36 MB
- Stars: 41
- Watchers: 1
- Forks: 2
- Open Issues: 20
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
[](https://pypi.org/project/gcop/)
[](https://github.com/Undertone0809/gcop/pulls?utf8=%E2%9C%93&q=is%3Apr%20author%3Aapp%2Fdependabot)
[](https://github.com/Undertone0809/gcop/releases)
[](https://github.com/Undertone0809/gcop/blob/main/LICENSE)
GCOP (Git Copilot) - Your AI-powered Git assistant that transforms messy commits into meaningful stories. It automates commit message generation, enhances your Git workflow, and makes version control a breeze with 20+ smart commands.
## 🚀 Key Features
1. **🤖 Intelligent Commit Crafting**
- Let AI analyze your changes and generate contextually perfect commit messages
- Learn from your project's commit history to match your team's style
2. **🎨 Highly Customizable Experience**
- Design your own commit templates to match project requirements
- Fine-tune commit message style with custom prompts
- Configure project-specific settings for consistent team standards
3. **📚 Smart Learning Capabilities**
- Automatically learn from your repository's commit history
- Adapt to your team's commit conventions over time
- Improve message quality through continuous learning
4. **⚡ Seamless Developer Experience**
- Supercharged with 20+ intuitive Git shortcuts and commands
- Smart aliases that make complex Git operations a breeze
- Integrate with your favorite AI models (OpenAI, Anthropic, etc.)
- Zero-config integration with your existing Git workflow
## Video Demo
This video shows how to use gcop to generate a commit message. See the [documentation](https://gcop.zeeland.top/)
[](https://www.youtube.com/watch?v=j7qKI_TdhXs "Gcop is your git AI copilot")
## 🛠️ Getting Started
We recommend you to read the [Quick Start Guide](https://gcop.zeeland.top/) in detail.
### What You'll Need
- Python 3.8 or newer
- Git installed on your system
- An API key for your preferred LLM (e.g., OpenAI, Anthropic)
### Installation
1. Install GCOP with pip:
```
pip install gcop
```
2. Initialize GCOP:
```
gcop init
```
> This command sets up GCOP and adds its aliases to your Git configuration.
3. Configure your AI model:
```
git gconfig
```
This opens the configuration file. Edit it to include your AI provider details:
```yaml
model:
model_name: provider/name, eg openai/gpt-4o
api_key: your_api_key
```
Then gcop will generate a `config.yaml`, then gcop will open the `config.yaml`
file in the default editor, and you can config your language model. See how to
config your model [here](https://gcop.zeeland.top/other/how-to-config-model.html):
> `config.yaml` store path:
>
> - Windows: `%USERPROFILE%\.zeeland\gcop\config.yaml`
> - Linux: `~/.zeeland/gcop/config.yaml`
> - MacOS: `~/.zeeland/gcop/config.yaml`
1. Verify the installation:
```
git ghelp
```
You should see output similar to:
```
gcop is your local git command copilot
Version: 1.0.0
GitHub: https://github.com/Undertone0809/gcop
Usage: git [OPTIONS] COMMAND
Commands:
git p Push changes to remote repository
git pf Force push changes to remote repository
git undo Undo last commit, keep changes
git ghelp Show this help message
git gconfig Open config file in default editor
git gcommit Generate AI commit message and commit changes
git ac Add all changes and commit with AI message
git c Shorthand for 'git gcommit'
```
## 💡 Basic Usage
### Generating AI Commit Messages
After making changes to your project:
1. Stage your changes:
```
git add .
```
2. Generate and apply an AI commit message:
```
git c
```
Example output:
```
? Select a commit message to commit (Use arrow keys)
» feat: Implement user authentication system
docs: Update installation instructions in README
fix: Resolve database connection timeout issue
style: Improve code formatting in src/main.py
retry
```
3. Choose the most appropriate message using arrow keys and press Enter.
### Other Useful Commands
- `git ac`: Add all changes and commit with an AI-generated message
```
git ac
```
Output:
```
Changes added. Generating commit message...
? Select a commit message to commit (Use arrow keys)
» feat: Add new user profile page
fix: Correct CSS styling issues on mobile devices
docs: Update API documentation for v2.0
refactor: Optimize database queries for better performance
retry
```
- `git undo`: Undo the last commit while keeping changes staged
```
git undo
```
Output:
```
HEAD is now at a1b2c3d Previous commit message
Changes from the last commit are now staged.
```
- `git p`: Push to the current branch
```
git p
```
Output:
```
Enumerating objects: 5, done.
Counting objects: 100% (5/5), done.
Delta compression using up to 8 threads
Compressing objects: 100% (3/3), done.
Writing objects: 100% (3/3), 328 bytes | 328.00 KiB/s, done.
Total 3 (delta 2), reused 0 (delta 0), pack-reused 0
To https://github.com/username/repo.git
a1b2c3d..e4f5g6h main -> main
```
- `git pf`: Force push to the current branch (use with caution)
- `git gconfig`: Open the GCOP configuration file for adjustments
## 🔧 Configuration
To modify your AI model settings:
1. Open the config file:
```
git gconfig
```
2. Edit the `config.yaml` file:
```yaml
model:
model_name: provider/name, eg openai/gpt-4o
api_key: your_api_key
```
3. Save and close the file.
## 📚 Learn More
- [Detailed Documentation](https://gcop.zeeland.top/)
- [Contribution Guidelines](CONTRIBUTING.md)
- [Changelog](https://github.com/Undertone0809/gcop/releases)
### Makefile usage
[`Makefile`](https://github.com/Undertone0809/gcop/blob/main/Makefile)
contains a lot of
functions for faster development.
Install all dependencies and pre-commit hooks
```bash
make install
```
Codestyle and type checks
Automatic formatting uses `ruff`.
```bash
make polish-codestyle
# or use synonym
make formatting
```
Codestyle checks only, without rewriting files:
```bash
make check-codestyle
```
> Note: `check-codestyle` uses `ruff` and `darglint` library
Code security
> If this command is not selected during installation, it cannnot be used.
```bash
make check-safety
```
This command launches `Poetry` integrity checks as well as identifies security issues
with `Safety` and `Bandit`.
```bash
make check-safety
```
Tests with coverage badges
Run `pytest`
```bash
make test
```
All linters
Of course there is a command to run all linters in one:
```bash
make lint
```
the same as:
```bash
make check-codestyle && make test && make check-safety
```
Docker
```bash
make docker-build
```
which is equivalent to:
```bash
make docker-build VERSION=latest
```
Remove docker image with
```bash
make docker-remove
```
More
information [about docker](https://github.com/Undertone0809/python-package-template/tree/main/%7B%7B%20cookiecutter.project_name%20%7D%7D/docker).
Cleanup
Delete pycache files
```bash
make pycache-remove
```
Remove package build
```bash
make build-remove
```
Delete .DS_STORE files
```bash
make dsstore-remove
```
Remove .mypycache
```bash
make mypycache-remove
```
Or to remove all above run:
```bash
make cleanup
```
## 📦 Techs
- [Promptulate: Large language model automation and Autonomous Language Agents development framework](https://github.com/Undertone0809/promptulate)
- [P3G: Python Packages Project Generator](https://github.com/Undertone0809/P3G)
## 🛡 License
[](https://github.com/Undertone0809/gcop/blob/main/LICENSE)
This project is licensed under the terms of the `MIT` license.
See [LICENSE](https://github.com/Undertone0809/gcop/blob/main/LICENSE) for more details.
## 🤝 Support
For more information, please
contact: [[email protected]](mailto:[email protected])
See anything changelog, describe the [telegram channel](https://t.me/zeeland0809)
## Credits [](https://github.com/Undertone0809/python-package-template)
This project was generated with [P3G](https://github.com/Undertone0809/P3G)