gitted 0.0.22

Collection of Bash scripts for Git auto-piloting, such as branch, push, pull, and commit.

Command-Line Shortcuts for a Primitive Git Flow

If all you need to do with Git is make branches, push, and sync, this collection of command-line commands may simplify your workflow. Well, it simplifies mine, a hundred times per day.

First, install Python3, Git, pip, gh, and Bash.

Then, install this Python package (with Bash scripts inside):

pip install gitted==0.0.21

Then, in order to make a contribution to a GitHub repo, assuming you've made a fork already and cloned it (in the command line):

First, start a branch to resolve issue no. 42 (for example):

branch 42

Then, write some code and add+commit it (no push):

commit 'Just fixed a small bug'

Then, pull recent changes from the master of the upstream:

pull

Finally, write more code and add+commit+push it:

push 'Just fixed a big bug'

If you omit the commit message for the commit or the push command, they will use ChatGPT to generate it, looking at the changes you've made. To make it work, define the OPENAI_API_KEY environment variable with the OpenAI key.

To use a different model, set GITTED_MODEL to its identifier; it defaults to gpt-3.5-turbo. To point at a different OpenAI-compatible endpoint (for example a local LLM such as Ollama or llama.cpp with the OpenAI shim, or any other proxy), set OPENAI_BASE_URL to the endpoint's URL; the openai Python client picks it up automatically.

Conventions

In order to work smoothly, you must respect a few conventions:

• Branch names are always integers, equal to GitHub issue numbers (why?)
• All commits are GPG-signed, if you have a key (how?)
• The origin is the fork, while the upstream is the main repo (why?)

Perhaps in future versions we'll make these configurable. However, at the moment, that's what we have.

How to Contribute

Install GNU make and uv. Then, run:

make

Should build. If it doesn't, submit a bug report.