- Notifications
You must be signed in to change notification settings - Fork2
GitHub CLI with keyboard control for easy account management 🐚
License
PiotrRut/BetterGitCLI
Folders and files
Name | Name | Last commit message | Last commit date | |
---|---|---|---|---|
Repository files navigation
Disclaimer: BetterGitCLI isnot 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 yourGitHub account directly from your shell with simple and intuitive UI. It's based onPyGithub which is a wrapper library around the official GitHub REST API.
See below for instructions on how to configure BetterGitCLI. Note that Python 3.6 or higher is required to run this program.
In order to grant access to your GitHub account you will need to authenticate with your GitHub access token. You can find instructionson how to obtain ithere.
Your token must grant access to"repo","user","delete_repo" and"admin:public_key". After generatingyour 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 willonly be stored locally on your machine.
You can either install this program usingpip orpipenv, or clone it and run locally with Python. Click on one of theoptions 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 cando 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 providedrequirements.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
To navigate the UI, use your arrow keys (up and down) and select optionsusingEnter. 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 yourpersonal 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
Some screenshots of BetterGitCLI in action 👇
Main Menu | Manage personal details | Manage a specific repo |
---|---|---|
![]() | ![]() | ![]() |
You can view the changeloghere.
All contributions to add new features, fix any bugs (if you spot any) or make the code better or more efficientare more than welcome - please raise anissue before you open a pull requestto make sure we're not working on the same feature/bugfix! 💫
About
GitHub CLI with keyboard control for easy account management 🐚
Topics
Resources
License
Uh oh!
There was an error while loading.Please reload this page.
Stars
Watchers
Forks
Uh oh!
There was an error while loading.Please reload this page.
Contributors2
Uh oh!
There was an error while loading.Please reload this page.