Skip to main content

BannerImg

Disclaimer: BetterGitCLI is not official GitHub software, nor is it in any way affiliated with GitHub.

BetterGitCli is a third party GitHub CLI made with Python, providing easier access to managing your GitHub account directly from your shell with simple and intuitive UI. It's based on PyGithub which is a wrapper library around the official GitHub REST API.

Configuration

See below for instructions on how to configure BetterGitCLI. Note that Python 3.6 or higher is required to run this program.

GitHub access

In order to gain access to your GitHub account you will need to authenticate with your GitHub access token. You can find instructions on how to obtain it here.

Your token must grant access to "repo", "user", "delete_repo" and "admin:public_key". After generating your token, export it as an environmental variable in your shell 👇🏻

# bash / zsh
$ export GITHUB_AUTH_TOKEN=<token>

# powershell
$env:GITHUB_AUTH_TOKEN = "token"

🚨 BetterGitCLI will never store your access token, and it will only be stored locally on your machine.

Installation

You can either install this program using pip or pipenv, or clone it and run locally with Python. Click on one of the options down below to reveal the instructions 👇🏻

Install package with pip (preferred)

Install BetterGitCLI using this command:

$ pip install bettergitcli

After installation, you can run it from anywhere in your shell 🎉

$ bettergitcli

Clone and run locally with Python

If you prefer to clone this repository and run BetterGitCLI locally using your Python interpreter, you can do that as well. Just remember that in this case you will have to install these dependencies manually:

  • PyInquirer, PyGithub, colorama

This can be done easily using the provided requirements.txt file by running this in the project root:

$ pip install -r requirements.txt

After installation, run the program inside the /better_git_cli directory:

$ python main.py

Usage

To navigate the UI, use your arrow keys (up and down) and select options using Enter. You can also exit the program at any time by using the ^C (Ctrl+C) combination, or by choosing the "Exit to shell" option.

Via the UI, you can view all your repositories, manage branches and deployments, manage your personal user details and much more! Current functions include:

  • Repository management
    • View and edit repository details, such as the description, default branches, visibility and more!
    • Delete repositories
    • Create a new repository
  • User management
    • View and edit your personal details like your name, location or bio
  • SSH keys management
    • View, create and delete SSH keys linked to your GitHub account
  • Language statistics
    • See what your top languages are

Changelog

You can view the changelog here.

Contributing

All contributions to add new features, fix any bugs (if you spot any) or make the code better or more efficient are more than welcome - please feel free to raise an issue or open up a pull request 💫

Metadata

Release files for bettergitcli 1.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for bettergitcli 1.3.0
File Size Uploaded
BetterGitCLI-1.3.0.tar.gz 21.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for bettergitcli 1.3.0
File Interpreter ABI Platform
BetterGitCLI-1.3.0-py3-none-any.whl Python 3 none any Details

Total release size: 44.1 kB

Release files / BetterGitCLI-1.3.0.tar.gz

Download URL BetterGitCLI-1.3.0.tar.gz
Size 21.3 kB
Tags Source
SHA-256 checksum
How to use checksums
69274cac269b1cf97190a5b3d9d85dd5eb28552112494d636abe452013dc1279
BLAKE2b-256 checksum
How to use checksums
8a1d226a739ffb110d3d33ade2f8a68b09341c24ce3bcea9414f9482e1672c17
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.1.5 CPython/3.6.7 Linux/4.15.0-1077-gcp

Release files / BetterGitCLI-1.3.0-py3-none-any.whl

Download URL BetterGitCLI-1.3.0-py3-none-any.whl
Size 22.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b4e0519b77d4606a833b72c76624644de9d1d2a2d595665836e99421f1641fbb
BLAKE2b-256 checksum
How to use checksums
ab29e946670353c3c535568e6a2dc6796817ffb2c93bd9d0fbb4acdbe9ae2290
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.1.5 CPython/3.6.7 Linux/4.15.0-1077-gcp

Release history Release notifications | RSS feed

This release

1.3.0 This release

2 release files

1.2

2 release files

1.1

2 release files

1.0.2

2 release files

1.0.1

2 release files

1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page