Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Command-line interface to GitHub

branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 bin
Octocat-spinner-32 cligh
Octocat-spinner-32 .gitignore
Octocat-spinner-32 AUTHORS
Octocat-spinner-32 LICENSE
Octocat-spinner-32 README.md
Octocat-spinner-32 setup.py
README.md

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.2. 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.2.tar.gz. You can verify the integrity of the file using the gpg signature.

Installation

If you are using a version of Python prior to 2.7, you first need to install the argparse module. Get it from here, or install it using pip install argparse. Python version 2.7 includes argparse in its standard library.

cligh also requires the PyGithub package. The homepage for PyGithub is 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, 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.

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 git://github.com/CMB/cligh.git

Patches are most appreciated. Please send them to chris@the-brannons.com.

Something went wrong with that request. Please try again.