node package manager


An Extended Fork of the Github.js library

Github.js provides a minimal higher-level wrapper around Github's API. It was concieved in the context of Prose, a content editor for GitHub.

Read the docs


Github.js is available from npm or unpkg.

npm install work-github


Github.js is tested on Node:

  • 7.0
  • 6.x
  • 5.x
  • 4.x
  • 0.12

GitHub Tools

The team behind Github.js has created a whole organization, called GitHub Tools, dedicated to GitHub and its API. In the near future this repository could be moved under the GitHub Tools organization as well. In the meantime, we recommend you to take a look at other projects of the organization.


   Data can be retrieved from the API either using callbacks (as in versions < 1.0)
   or using a new promise-based API. For now the promise-based API just returns the
   raw HTTP request promise; this might change in the next version.
import GitHub from 'github-api';
// unauthenticated client 
const gh = new GitHub();
let gist = gh.getGist(); // not a gist yet 
   public: true,
   description: 'My first gist',
   files: {
      "file1.txt": {
         content: "Aren't gists great!"
}).then(function({data}) {
   // Promises! 
   let gistJson = data;, gist, xhr) {
      // if no error occurred then err == null 
      // gistJson === 
      // xhr === httpResponse 
import GitHub from 'github-api';
// basic auth 
const gh = new GitHub({
   username: 'FOO',
   password: 'NotFoo'
const me = gh.getUser();
me.listNotifications(function(err, notifications) {
   // do some stuff 
const clayreimann = gh.getUser('clayreimann');
   .then(function({data: reposJson}) {
      // do stuff with reposJson 
var GitHub = require('github-api');
// token auth 
var gh = new GitHub({
   token: 'MY_OAUTH_TOKEN'
var yahoo = gh.getOrganization('yahoo');
yahoo.listRepos(function(err, repos) {
   // look at all the repos!