Alfred GitFred

Helpful GitHub assistant for Alfred.

Usage

• Search all public GitHub repositories via the keyword gh.
  • Uses the GitHub search query syntax, for example alfred user:chrisgrieser to search for repositories with the name alfred by the user chrisgrieser.
  • ⏎: Open the repo's GitHub page.
  • ⌘⏎: Open the repo's homepage. If it has none, opens the releases page instead.
  • ⌥⏎: Copy the repo URL.
  • ⌃⏎: Clone the repo to a local folder and open in the Terminal.
• Access your repositories via gmy. (Limited to the 100 repos last updated.)
  • ⏎: If the repo is available locally on your device, open it in the terminal. Otherwise, open the repo's GitHub page.
  • ⌘⏎: Open the repo's GitHub page.
  • ⌥⏎: Copy the repo URL.
  • ⇧⏎: Clone the repo to a local folder and open in the Terminal. If the repo is already locally available on your device, just open the repository in the Terminal.
• Open recent GitHub issues you are involved in with ghi.
  • ⏎: Open the issue in the browser.
  • ⌥⏎: Copy the issue URL.
• Access PRs you have opened with the keyword gpr.
  • ⏎: Open the PR in the browser.
  • ⌥⏎: Copy the link to the PR.
• Directly open your GitHub notification via ghn.
  • Requires GitHub Token.
  • ⏎: Open the notification in the browser. In cases where no URL is available, such as deleted comments or CI activity, opens the GitHub notification inbox instead.
  • ⌘⏎: Mark the notification as read.
  • ⌥⏎: Copy the URL of the notification target.
  • ⌃⏎: Mark the notification as done.
• Additionally, you can press the hotkey to clone a GitHub repo from the current browser tab. (Note that Firefox is not supported.)

GitHub Token

The GITHUB_TOKEN is optional and only required for showing notifications, private repos, PRs, and issues repos. The token requires the respective access rights.

Note that other than for notifications, the workflow does not use the token by default, since including private noticeably slows down the search. To search private repos, PRs, and issues, you also need to enable the respective workflow setting.

The workflow will check for the token in the following order:

1. The GITHUB_TOKEN in the Alfred workflow configuration.
2. A shell command that outputs your GITHUB_TOKEN, such as cat $HOME/my_token.txt, defined in your workflow settings.
3. A token exported in your .zshenv, such as export GITHUB_TOKEN=….

Installation

➡️ Download the latest release.

About the developer

In my day job, I am a sociologist studying the social mechanisms underlying the digital economy. For my PhD project, I investigate the governance of the app economy and how software ecosystems manage the tension between innovation and compatibility. If you are interested in this subject, feel free to get in touch.

• Website
• Mastodon
• ResearchGate
• LinkedIn