GitHub Repos

An Alfred Workflow


Short Description

Easily open GitHub repositories

Last Updated

12 Apr 2021

Compatibility

Yosemite
(10.10)
Mavericks
(10.9)
Mountain Lion
(10.8)
Lion
(10.7)
Snow Leopard
(10.6)
Yes No No No No
 

Version

3.1.2
 

Bundle ID

edgarjs.github-repos.workflow
 

Author

GitHub Repos workflow for Alfred

This is a custom workflow for the Alfred app that lets you search and open a GitHub repository via the GitHub Search API.

Authentication

You'll need to authenticate with a personal access token that you can generate in the GitHub developer settings page or by running the gh-token command in Alfred.

After you have copied your personal access token, run gh-login <your-token> to set your personal access token.

Usage

Here's the list of available commands.

Global Search: gh <query>

The example above will search for repositories with the string "hello-world" in their name. Internally this uses the GitHub Search syntax, so you can use modifiers like:

gh hello-world stars:>100

This will search only in repositories that have more than 100 stars.

Please note that this command only searches in the repository name. This means that your query will be appended with the in:name modifier. So when you type in hello-world, the final search query sent will be: "hello-world in:name".

Search your repositories: repo [query]

This command works the same as the previous one (gh <query>) but it limits the search to your own repositories.

This includes repositories from your organizations as well.

Search Pull Requests: pr [query]

This command searches within the Pull Requests that you're involved in.

Open notifications: gh-notifications

This command just opens your GitHub notification page.

Configuring host for Enterprise

If you're using an Enterprise account, you can call the gh-host <host> command.


Contributing

You can submit your bug reports or feature requests at: https://github.com/edgarjs/alfred-github-repos/issues

If you want to submit a Pull Request, please follow these simple guides:

  1. Add a detailed description of what you're changing and why.
  2. Add necessary unit tests that cover your changes.
  3. Don't increase the version of the workflow in your changes.

Here are some ideas for Pull Requests:

  • [ ] Make search faster
  • [ ] Search commits in a repository
  • [ ] Search projects in an organization
  • [ ] Improve icon graphics

License

This project is published under the MIT License.

Screenshots