# cligh - Command-line Interface to GitHub

This is a simple command-line interface to the facilities of GitHub.
It is written by Christopher Brannon <chris@the-brannons.com>.
The current version is 0.3,
released July 23, 2016.
This program is still in the early stage of development.
It is by no means feature-complete.
A friend and I consider it useful, but others may not.

## Obtaining

Obtain the current stable version using this link:
<http://the-brannons.com/software/cligh-0.3.tar.gz>.
You can verify the integrity of the file using the
[gpg signature](http://the-brannons.com/software/cligh-0.3.tar.gz.sig).

## Installation

This program is written in Python 3.x.
There is no backward compatibility with 2.x, since 3.x is the future.

cligh requires the PyGithub package.
The homepage for PyGithub is
[https://github.com/jacquev6/PyGithub](https://github.com/jacquev6/PyGithub).
It can also be installed using `pip install PyGithub`.

The final dependency is PyXDG.
Get it from
[http://freedesktop.org/Software/pyxdg](http://freedesktop.org/Software/pyxdg),
or install it using `pip install pyxdg`.

Once the dependencies are installed,
 type `./setup.py install` in the cligh source directory, in order to install
the script and its helper modules.

## Setup

Run the following command to configure cligh:

    cligh configure

The program will prompt you for a username and password.  It then creates
an authorization using the Github API.
cligh never stores your password.  Instead, it stores the token associated
with the authorization that it created.
It uses this token to authenticate to Github.

## Usage

Usage is straightforward, and the program provides informative help
messages.  Simply type `cligh -h` at a shell prompt,
to see the introductory help message.

## Development

The source for this project is managed by git.  If you wish to contribute,
or if you simply wish to use the unpublished "development" sources, clone
it using a command such as the following:

    git clone https://github.com/CMB/cligh.git

Patches are most appreciated.  Please send them to [chris@the-brannons.com](mailto:chris@the-brannons.com).

# Project Discontinued

I'm planning on deleting the repo this month.  If someone else has a
fork and would be interested in maintaining this going forward, please
email me.

Add notice about deleting this repo.
Add notice about deleting this repo.
