Skip to main content

His pointless toil will never end

Project description

His pointless toil will never end.

Mr. Sisyphus is a tool to improve the permissions for github organisations. It will allow users to create repositories without having to made admins of repositories. It requires an organisation in GitHub with three teams.

  • The Owners team is created by default

  • A team that holds all the developers in the organisation, with Push and Pull rights set

  • A new team for this package that has Push, Pull and Admin rights set.

This new team should not be administered by the organisation admins, they should just administer the Owners and Developers teams.


You will need to customise the mr.sisyphus.cfg file with information about your organisation. A default is provided for the organisation collective. In this organisation the teams listed above are named, respectively:

  • Owners

  • –auto-contributors

  • CanAdd

therefore the configuration file looks like:

organization = collective
developer_team = --auto-contributors
stub_team = CanAdd

The first time you run the script it will prompt for your GitHub username and password. The user you authenticate as must be a member of the Owners team in the organisation you want to administer. It will then create an OAuth token and store it in the mr.sisyphus.cfg file. From this point on the configuration file should be considered secret, as there is no way to get an OAuth token that applies just to one organisation. If someone finds this token they’d gain admin access to your private repos. The OAuth token can be disabled from your GitHub user profile, but you won’t be prompted to log in again unless you delete it from the config file.

From this point on the script can be run in non-interactive mode

Dry Run

To see what mr.sisyphus is planning to do invoke it as ./bin/mr.sisyphus.cfg -n and it will skip making the actual calls to github.

Project details

Release history Release notifications | RSS feed

This version


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution (10.0 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page