Skip to main content

Manage your issues from the command line.

Project description

Build Status Coverage Status Python versions License

Manage your Github, Gitlab or Bitbucket issues from the command line.

Built on Cement Framework.


  • Compatible with Github, Bitbucket and Gitlab ( and self hosted installations).
  • Authentication.
  • List the issues.
  • Get issues descriptions.
  • Get comment thread of the issue.
  • Show tags of each issue, with its colors.


  • No “write” operations (i.e. make a comment, open or close issues, etc.).


Just with pip3:

pip3 install gitssue

That’s it! You can already execute gitssue in your shell. You don’t have to specify the link to the tracker or the remote type (Github, Gitlab or Bitbucket); it’s already done by Gitssue.


This is optional, just if you want to use authentication (necessary for Github and Bitbucket private repositories, and Gitlab repositories).

Take a look to the .gitssuerc.example file, and follow these steps:

  • Change the values of the example file with the real ones.
  • Rename it to .gitssuerc.
  • Place it in your home directory (~/.gitssuerc), or in /etc/. If a config file exists in both directories, the one of the home directory will be the one used.
  • Check the permissions! The config file stores your credentials, so you will probably want to have permissions like 500 (read and write permissions for the owner, and no permissions for any other) or similar.

Gitlab access token

Even if the repository is public, you need an access token. This can be generated under Settings/Access Tokens, with the api scope.

Project details

Download files

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

Files for Gitssue, version 2.0.0
Filename, size File type Python version Upload date Hashes
Filename, size Gitssue-2.0.0.tar.gz (16.1 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page