giton is an AI augmentation program for git. It uses OpenAI GPT-4, and your local git context to make command suggestions. giton is a passthrough for git commands, so you can already use it as a replacement for git.
Table of Contents
You need git installed and accessible from your commandline.
You can download the relevant binary from the latest release. Linux, macOS and Windows binaries are available for x86_64.
If you have the rust toolchain installed, you can install giton with cargo
cargo install gitonYou need an OpenAI API Key to be able to use giton. After creating an account with OpenAI, you can generate an API key. Then, you need to set this API key in your shell environment.
For Linux/macOS
export GITON_OPENAI_KEY=your_api_keyFor Windows/Powershell
$env:GITON_OPENAI_KEY = "your_api_key"giton stores your commands history in the file .giton in the root of your directory. It is recommended to track this file as it improves the accuracy of the undo and helpme commands.
Usage
giton historyOutput
2023-12-13 20:01:45: status
2023-12-20 00:56:03: add .
2023-12-20 00:56:20: commit -m imp(display): add spinners
helpme uses your current repository context to suggest possible commands.
Usage
giton helpme
Output
⢿ Communicating with Open AI
+---+----------------------------------------------+
| # | Command |
+==================================================+
| 0 | git add README.md |
|---+----------------------------------------------|
| 1 | git commit -m "chore(readme): update README" |
+---+----------------------------------------------+
:: Prooced with Command(s)?: [Y/n]
undo uses giton stored history to suggest a command (or set of commands) that cancels out your previous command.
Usage
giton undo
Output
⣷ Communicating with Open AI
+---+------------------------------------------+
| # | Command |
+==============================================+
| 0 | git restore --staged core/src/command.rs |
+---+------------------------------------------+
:: Prooced with Command(s)?: [Y/n]
GPT-4 is not free and can actually be pricey. Only the helpme and undo commands make calls to GPT-4; all other commands (including git passthrough commands) do not make calls to GPT-4.
It is hard to estimate the cost of GPT-4 calls. I recommend you frequently check the usage tab in the Open AI dashboard to get an idea of the cost; and adjust your consumption accordingly.
For reporting a security vulnerability, you can directly send me an email.
giton is distributed under the MIT License.
See LICENSE for details.