Command line interface for GitHub

cli-app, github
pip install github-cli-app==1.0.8


:octocat: Github CLI application

Build Status Codacy Badge Codacy Badge License GitHub commit activity the past week Requirements Status Platform Python versions GitHub repo size in bytes Documentation Status Pypi SourceRank Say Thanks!

Ever wanted to browse your repos through CLI? Or create a new one without the hassle of opening the browser? Now you can!

What is this project? 🐫

This project uses Github v4 API, Github v3 API and Python to provide you with command line interface. Thus you don't have to leave Guake (or you other favourite terminal) in order to create new repo for your next project, or to see URL of you existing projects, or do whatever the API allows you.

Focus of this project is on simplicity - arguments are intuitive and provided as keywords (some flags are also available).

Requirements 🚀

All you have to do (except installing this application, of course) is to register you API key within Github. To do so, navigate to your settings and choose Developer settings. There, in Personal access tokens section, create new token with full rights (you can actually omit rights you know you don't want to use). Copy this token and save it to file api_key in project directory. Beware, make sure no one shady gains access to it, as this key enables anyone to do anything with your Github account.

Installation 🐳

This project requires Python>=3.6

From PyPI via pip

execute in terminal

pip install github-cli-app

or in case you have both python2 and python3 installed

pip3 install github-cli-app.

It may also occur that you get error like pip not found, or so. In that case, make sure you have appropriate python-pip or python3-pip installed. If you have and it still doesn't work, execute following command

python -m pip install github-cli-app


python3 -m pip install github-cli-app

From GitHub

(for troubleshooting see Installation from PyPI)

  1. clone this repository (or download and extract release) and navigate to its root
  2. execute pip install . If you want to install only as a user, execute pip install --user . If you want to always use the newest version, execute pip install -e . (or also with user flag). This will allow executing github dynamically, so you can have new functionality with every pull .

Features and usage 🚧

(tick marks implemented features)

execute github with following options and/or arguments [ this means optional ]:

  • list-my-repositories
  • list-user-repositories USERNAME
  • create-repository REPOSITORY_NAME [--private] [--description DESCRIPTION]
  • delete-repository REPOSITORY_NAME
  • create-new-project REPOSITORY_NAME PROJECT_NAME

more to come!


  • Michal Polovka @miskopo


This project is in no way affiliated with Github and it's not official part of Github :octocat: per se (yet).