Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Ulauncher Github

ulauncher Extension that provides quick access to common GitHub functionality like your repositorie, assigned issues or Pull Requests and many more. CI Status Ulauncher Extension License




  • Quick access to your repositories and organizations.
  • Access to your Issues and Pull Requests (Assigned, Created)
  • Search public repos and users
  • Search on GitHub Documentation pages

Getting started


This extension requires Python > 3 and a few python packages installed on your system.

To install them, you can run the following command, on your terminal:

pip install -r

Install the extension

Open ulauncher preferences window -> extensions -> add extension and paste the following url:

Extension Settings

Before being able to start using the extension, you must generate a Personal Access Token (PAT) and configure it in the extension settings. The access token will allow the extension to access the GitHub API.

You can generate yours here. Make sure you select at least the permissions for "repo", "read:org", "gist", "user" and "notifications", otherwise you might see errors when using some specific commands in the extension.


This extension provides various commands/keywords to access the different functionality. If you type GitHub in Ulauncher you should see the available commands.

Extension Screenshot

These include:

  • GitHub: Search Repositories
  • GitHub: Search Users
  • GitHub: My Gists
  • GitHub: My Organizations
  • GitHub: My Assigned Issues
  • GitHub: My Created Issues
  • GitHub: My Assigned Pull Requests
  • GitHub: My Created Pull Requests
  • GitHub: My Notifications
  • GitHub: My Repositories
  • GitHub: My Account
  • GitHub: Search Documentation
  • GitHub: Extension Options

Note on Cache

When the extension starts, it will download a list of all of your repositories, stars and gists and save them in a json file. This helps for performance reasons and GitHub API doesn´t have a way to search on your own and organizations repostories in the same request.

This information is cached for 1 day by default. You can clear your cache and trigger a reindex of the local data by restarting ulauncher or by going to GitHub: Extension Options -> Refresh cache.

Depending on the number of repositories you have access, this indexing process might take some time. It is executed in the background and you will receive a notification when the process finishes.


git clone
make link

The make link will create a symbolic link to the ulauncher extensions folder.

Next, stop Ulauncher if running and run the following command:

make dev

This will start Ulauncher from the command line with all extensions disabled. In the output you will see something like this:

 VERBOSE=1 ULAUNCHER_WS_API=ws:// PYTHONPATH=/usr/lib/python3.8/site-packages /usr/bin/python3 /home/bruno/.local/share/ulauncher/extensions/com.github.brpaz.ulauncher-github/

Run this, command in another terminal window, to laucnh the GitHub Extension.


  • Cache user repositories, gists and organizations in background for faster results.


Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

💛 Support the project

If this project was useful to you in some form, I would be glad to have your support. It will help to keep the project alive and to have more time to work on Open Source.

The sinplest form of support is to give a ⭐️ to this repo.

You can also contribute with GitHub Sponsors.

GitHub Sponsors

Or if you prefer a one time donation to the project, you can simple:

Buy Me A Coffee

📝 License

Copyright © 2020 Bruno Paz.

This project is MIT licensed.


Ulauncher Extension that provides quick access to common GitHub functionality like your repositories or gists.








No packages published

Contributors 4