PowerToysRun-GitHubRepo

GitHubRepo Plugin for PowerToys Run

This is a plugin for PowerToys Run that allows to search for GitHub repositories then open in your default browser.

Check out the Template for a starting point to create your own plugin.

Features

Search repo with query: query

Search repo with user: user/repo

Search repo with default user: /repo

If auth token is set, it will list all the repositories the token has access to. Otherwise, it will list all the public repositories of the default user.

Context menu

• Open issues: Open the issues page of the repository Ctrl+I.
• Open pull requests: Open the pull requests page of the repository Ctrl+P.
• Copy link: Copy the repository link to clipboard Ctrl+C.

Settings

• Default user: The user(s) to search for when typed /; enter multiple users on separate lines.
• GitHub auth token (optional): The GitHub auth token to use for better rate limiting and access to private repo. For multiple default users, enter tokens on separate lines in the same order as the users. You can generate a fine-grained token with read access to metadata. Detailed instructions here.

Installation

Manual

1. Download the latest release of the from the releases page.
2. Extract the zip file’s contents to %LocalAppData%\Microsoft\PowerToys\PowerToys Run\Plugins
3. Restart PowerToys.

Via ptr

ptr add GitHubRepo 8LWXpg/PowerToysRun-GitHubRepo

Usage

1. Open PowerToys Run (default shortcut is Alt+Space).
2. Type gr followed by your search query.
3. Select a search result and press Enter to open it in browser.

Building

1. Clone the repository and the dependencies in /lib with GitHubRepo/copyLib.ps1.
2. Run dotnet build -c Release.

Debugging

1. Clone the repository and the dependencies in /lib with GitHubRepo/copyLib.ps1.
2. Build the project in Debug configuration: dotnet build -c Debug -p:Platform=x64.
3. Make sure you have gsudo installed in the path.
4. Run debug.ps1 (change $ptPath if you have PowerToys installed in a different location).
5. Attach to the PowerToys.PowerLauncher process in Visual Studio.

Contributing

Localization

If you want to help localize this plugin, please check the localization guide