Flow.Plugin.Github

Github plugin for the Flow launcher

About

Search Github repositories, navigate repository issues and pull requests, directly from Flow-Launcher.

Usage

note: The plugin supports many sub-query formats, use whatever suits you best...

Search for repos:

• gh repos {repo-search-term}

Search for users:

• gh users {user-search-term}

List repositories by user:

• gh {owner}/

Display repository info:

• gh {owner}/{repo}

List repository issues:

• gh {owner}/{repo}/issues
• gh {owner}/{repo} issues
• gh issues {owner}/{repo}

List repository pull requests:

• gh {owner}/{repo}/pulls
• gh {owner}/{repo} pull
• gh {owner}/{repo} pr
• gh pull {owner}/{repo}
• gh pr {owner}/{repo}

Find specific issue or pull request:

• gh {owner}/{repo}#123
• gh {owner}/{repo} #123
• gh {owner}/{repo}/issue/123
• gh {owner}/{repo}/pull/123

Access Token

To avoid rate limits from Github's API, after installing the plugin do the following:

1. open Github and generate a new personal access token
2. hit Enter on the Rate Limit result, or manually open %AppData%\FlowLauncher\Settings\Plugins\Flow.Plugin.Github\Settings.json
3. add your token in the GithubApiToken value and save the file

Private Repositories

Simply check the repo scope when generating the access token.

Credits

• octokit.net : A GitHub API client library for .NET
• expecto : testing library
• humanizer : Library used to turn date-times into a relative format
• Github Icon : Icon used