https://github.com/chrisgrieser/gitfred
Helpful GitHub assistant for Alfred.
https://github.com/chrisgrieser/gitfred
alfred-workflow github-client github-search
Last synced: 2 months ago
JSON representation
Helpful GitHub assistant for Alfred.
- Host: GitHub
- URL: https://github.com/chrisgrieser/gitfred
- Owner: chrisgrieser
- License: mit
- Created: 2023-12-31T20:12:10.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-11-07T14:11:30.000Z (3 months ago)
- Last Synced: 2025-11-07T15:29:00.999Z (3 months ago)
- Topics: alfred-workflow, github-client, github-search
- Language: JavaScript
- Homepage:
- Size: 200 KB
- Stars: 41
- Watchers: 2
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Alfred GitFred
Helpful GitHub assistant for Alfred.
## Usage
- Search all public GitHub repositories via the keyword `gh`.
* Uses the [GitHub search query
syntax](https://docs.github.com/en/search-github/searching-on-github/searching-for-repositories),
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`.
* ⏎: 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](https://github.com/settings/tokens).
* ⏎: 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](https://www.alfredapp.com/help/workflows/triggers/hotkey/) to clone
a GitHub repo from the current browser tab. ([Note that Firefox is not
supported.](https://www.alfredforum.com/topic/16748-how-to-do-x-in-firefox-from-alfred/))
## 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.](https://github.com/chrisgrieser/gitfred/releases/latest)
## 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](https://chris-grieser.de/)
- [Mastodon](https://pkm.social/@pseudometa)
- [ResearchGate](https://www.researchgate.net/profile/Christopher-Grieser)
- [LinkedIn](https://www.linkedin.com/in/christopher-grieser-ba693b17a/)
