{"id":16057766,"url":"https://github.com/giton-app/giton-cli","last_synced_at":"2025-03-18T04:31:15.266Z","repository":{"id":209150681,"uuid":"716058503","full_name":"Giton-App/giton-cli","owner":"Giton-App","description":"AI augmentation for Git","archived":false,"fork":false,"pushed_at":"2024-02-06T09:25:03.000Z","size":72,"stargazers_count":3,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-16T17:11:28.276Z","etag":null,"topics":["ai","augmentation","cli","git"],"latest_commit_sha":null,"homepage":"https://giton-app.github.io","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Giton-App.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-11-08T11:34:12.000Z","updated_at":"2024-02-08T05:14:30.000Z","dependencies_parsed_at":"2024-10-27T17:20:32.515Z","dependency_job_id":"6f468080-551c-4846-9bc9-3c96e014e391","html_url":"https://github.com/Giton-App/giton-cli","commit_stats":null,"previous_names":["giton-app/giton-cli"],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Giton-App%2Fgiton-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Giton-App%2Fgiton-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Giton-App%2Fgiton-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Giton-App%2Fgiton-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Giton-App","download_url":"https://codeload.github.com/Giton-App/giton-cli/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244156684,"owners_count":20407553,"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","augmentation","cli","git"],"created_at":"2024-10-09T03:04:38.445Z","updated_at":"2025-03-18T04:31:14.785Z","avatar_url":"https://github.com/Giton-App.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n\u003ca href=\"https://Giton-App.github.io\"\u003e\u003cimg src=\"https://raw.githubusercontent.com/Giton-App/giton-cli/main/docs/logo.svg\" height=\"100px\"/\u003e\u003c/a\u003e\n \u003c/p\u003e\n\u003ch1 align=\"center\"\u003egiton\u003c/h1\u003e\n\u003cdiv align=\"center\"\u003e\n \u003cstrong\u003e\n    AI augmentation for Git\n \u003c/strong\u003e\n\u003c/div\u003e\n\u003cbr/\u003e\n\n[![Build](https://github.com/Giton-App/giton-cli/actions/workflows/build.yml/badge.svg)](https://github.com/Giton-App/giton-cli/actions/workflows/build.yml)\n[![Tests](https://github.com/Giton-App/giton-cli/actions/workflows/test.yml/badge.svg)](https://github.com/Giton-App/giton-cli/actions/workflows/test.yml)\n[![Crates.io](https://img.shields.io/crates/v/giton.svg)](https://crates.io/crates/giton)\n[![MIT License](https://img.shields.io/github/license/Giton-App/giton-cli)](https://github.com/Giton-App/giton-cli/LICENSE)\n\n`giton` is an AI augmentation program for `git`. It uses [OpenAI GPT-4](https://openai.com/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.\n\n\u003c!-- START doctoc generated TOC please keep comment here to allow auto update --\u003e\n\u003c!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE --\u003e\n**Table of Contents**\n\n- [Installation](#installation)\n  - [Pre-Built Binaries](#pre-built-binaries)\n  - [Compilation with Cargo](#compilation-with-cargo)\n- [Configuration](#configuration)\n- [Commands](#commands)\n  - [history](#history)\n  - [helpme](#helpme)\n  - [undo](#undo)\n- [GPT-4 Costs](#gpt-4-costs)\n- [Vulnerability reporting](#vulnerability-reporting)\n- [License](#license)\n\n\u003c!-- END doctoc generated TOC please keep comment here to allow auto update --\u003e\n\n### Installation\n\n\u003e You need [git](https://git-scm.com) installed and accessible from your commandline.\n\n#### Pre-Built Binaries\n\nYou can download the relevant binary from the [latest release](https://github.com/Giton-App/giton-cli/releases). Linux, macOS and Windows binaries are available for x86_64.\n\n#### Compilation with Cargo\n\nIf you have the rust toolchain installed, you can install `giton` with `cargo`\n\n```sh\ncargo install giton\n```\n\n### Configuration\n\nYou need an [OpenAI API Key](https://help.openai.com/en/articles/4936850-where-do-i-find-my-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.\n\nFor Linux/macOS\n\n```sh\nexport GITON_OPENAI_KEY=your_api_key\n```\n\nFor Windows/Powershell\n\n```powershell\n$env:GITON_OPENAI_KEY = \"your_api_key\"\n```\n\n### Commands\n\n#### history\n\n`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. \n\nUsage\n\n```sh\ngiton history\n```\n\nOutput\n\n```\n2023-12-13 20:01:45: status\n2023-12-20 00:56:03: add .\n2023-12-20 00:56:20: commit -m imp(display): add spinners\n```\n\n#### helpme\n\n`helpme` uses your current repository context to suggest possible commands.\n\nUsage\n\n```\ngiton helpme\n```\n\nOutput\n\n```\n⢿ Communicating with Open AI\n+---+----------------------------------------------+\n| # | Command                                      |\n+==================================================+\n| 0 | git add README.md                            |\n|---+----------------------------------------------|\n| 1 | git commit -m \"chore(readme): update README\" |\n+---+----------------------------------------------+\n\n:: Prooced with Command(s)?: [Y/n]\n```\n\n#### undo\n\n`undo` uses `giton` stored history to suggest a command (or set of commands) that cancels out your previous command.\n\nUsage\n\n```\ngiton undo\n```\n\nOutput\n\n```\n⣷ Communicating with Open AI\n+---+------------------------------------------+\n| # | Command                                  |\n+==============================================+\n| 0 | git restore --staged core/src/command.rs |\n+---+------------------------------------------+\n\n:: Prooced with Command(s)?: [Y/n]\n```\n\n### GPT-4 Costs\n\nGPT-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.\n\nIt 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.\n\n### Vulnerability reporting\n\nFor reporting a security vulnerability, you can directly [send me an email](mailto:giton@omarabid.com).\n\n### License\n\ngiton is distributed under the MIT License.\n\nSee [LICENSE](LICENSE) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgiton-app%2Fgiton-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgiton-app%2Fgiton-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgiton-app%2Fgiton-cli/lists"}