A Git CLI designed for efficent project management
While the vanilla GitHub CLI is a fantastic developer tool that dramatically simplifies collaboration on a project, it lacks several features. We have to rely on the GUI to use some of them, such as Github projects and notifications.
The lack of these features was our motivation to build this project so that not only us but thousands of other CLI-loving devs can make their "Git" experience truly "good".
This package was built by Rohan Rout, Ali Farhan Hassan Kiyani, Sakshi Rambhia and Ankit Maity.
You'll need to have Python (>= 3.7) and pip to get started. If you don't have them installed already, see the official docs!
Once you're done, move on to the next steps below. ⬇
$ pip install gitgoodYep, that's it. ⚡
After installation, check if gg is actually up and running like:
$ gg
Usage: gg [OPTIONS] COMMAND [ARGS]...
Here to help! ✨
...And you're set! 🚀
You'll need your GitHub personal access token to make use of the CLI. You can make a new token here.
If you already have one, you can make a .gg file in your home folder like this (recommended):
GG_PAT=<your super secret token>And the CLI will automatically pick it up, or you can set the GG_PAT environment variable yourself.
If this is all too much, don't fret! The first time you run gg on the CLI, you'll get instructions on how to make one. Easy-peezy, lemon-squeezy. 🍋
It is highly recommended you use Poetry or virtual environments for building the project (such as Python's venv or the virtualenv module) to easily manage dependencies.
$ git clone git@github.com:QEDK/gitgood.git
$ cd gitgood
$ pip3 install poetry
$ poetry install
$ poetry shellOr if you prefer it hardball, just do pip3 install -r requirements.txt.
You can also use poetry to build the binaries:
$ poetry buildYou're now ready to work on gitgood! 🥳
There are two commands that operate in the app. They are "project" and "notifs".
- Project Management: The command "project" deals with tasks realted to viewing/managing the projects and their content(columns, cards etc)
Arguments: repo_address : this is the address of the repository in the form of user_name/repository_name. For ex: "QEDK/gitgood"
- Notification management: The command "notifs" deals with the tasks related to notifications.
Arguments: This command have following arguments.
- [LIMIT] (type: int) : This argument is OPTIONAL and prints only [LIMIT] no of notifications.
- read(type: string) : This is used to mark a specific no. of notifications as READ. Use 'A' for all notifications or any.
- repo-notif (type: string): This prints all the notifications in the repository mentioned in the argument.
$ gg project <repo_address>Example
$ gg project QEDK/gitgood$ gg project <repo_address> --columnsExample
$ gg project QEDK/gitgood --columns$ gg project <repo_address> --project-card <project_name>Example
$ gg project QEDK/gitgood --project-card App$ gg project <repo_address> --move <card_id>Example
$ gg project QEDK/gitgood --move 1234567$ gg notifs [LIMIT] (type: int)Example
$ gg notifs 2$ gg notifs --read [read]Example
$ gg notifs --read 2$ gg notifs --repo-notifs <repository_name>Example
$ gg notifs --repo-notifs gitgood- Python - Programming Language
- Typer - Python CLI library
- Github Api - API
- PyGithub - Github API Package
- flask8 - Linting tool
- Poetry - Packaging and publishing
This project is released under a free and open-source software license, Apache License 2.0 or later (LICENSE or https://www.apache.org/licenses/LICENSE-2.0). The documentation is also released under a free documentation license, namely the GFDL v1.3 license or later.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be licensed as above, without any additional terms or conditions.