GitHub Workflow for Alfred

You can search through GitHub (gh) and your GitHub Enterprise Cloud/self-hosted instance (ghe).

DOWNLOAD

Setup

This workflow requires PHP, which is no longer pre-installed since macOS 12 Montery.
You can install it via Homebrew (brew install php).

For github.com

In Alfred type gh > login to authenticate against your account. The login uses OAuth, so you do not have to enter your credentials.

For GitHub Enterprise Cloud

1. In Alfred type ghe > url https://github.com/enterprises/<enterprise-slug>.
2. Create a new Personal Access Token (ghe > generate token or https://github.com/settings/tokens). It only needs access to your repos. If your enterprise enforces SAML SSO, make sure to authorize the token for the relevant organizations.
3. In Alfred type (ghe > login <paste token here>)
4. You can now use ghe your_enterprise_repo_name

For GitHub Enterprise Server (self-hosted)

1. In Alfred type ghe > url https://github.mycompany.com
2. Create a new Personal Access Token (ghe > generate token or https://github.mycompany.com/settings/applications). It only needs access to your repos. Copy this token to your clipboard.
3. In Alfred type (ghe > login <paste token here>)
4. You can now use ghe your_enterprise_repo_name

Access to private repositories in organizations

Organizations must approve this app, otherwise private repositories of that organization can not be accessed. Access can be requested here.

Key Combinations

Key Combination	Action
enter	Open entry in default browser
cmd + c	Copy URL of the entry
cmd + enter	Paste URL to front most app
shift or cmd + y	Open URL in QuickLook

Commands

To search through your GitHub Enterprise instance replace gh by ghe.

Repo commands

• gh user/repo
• gh user/repo #123
• gh user/repo @branch
• gh user/repo *commit
• gh user/repo /path/to/file
• gh user/repo actions
• gh user/repo admin
• gh user/repo clone
• gh user/repo dev
• gh user/repo discussions
• gh user/repo graphs
• gh user/repo issues
• gh user/repo milestones
• gh user/repo network
• gh user/repo new issue
• gh user/repo new pull
• gh user/repo projects
• gh user/repo pulls
• gh user/repo pulse
• gh user/repo releases
• gh user/repo wiki
• gh user/repo projects

User commands

• gh @user
• gh @user overview
• gh @user repositories
• gh @user stars
• gh @user gists

Search commands

• gh s repo
• gh s @user

"My" commands

• gh my dashboard
• gh my notifications
• gh my profile
• gh my issues
• gh my issues created
• gh my issues assigned
• gh my issues mentioned
• gh my pulls
• gh my pulls created
• gh my pulls assigned
• gh my pulls mentioned
• gh my pulls review requested
• gh my repos
• gh my repos new
• gh my settings
• gh my stars
• gh my gists

Workflow commands

• gh > login
• gh > logout
• gh > delete cache
• gh > delete database
• gh > update
• gh > activate autoupdate
• gh > deactivate autoupdate
• gh > help
• gh > changelog
• ghe > url (GitHub Enterprise only)
• ghe > generate token (GitHub Enterprise only)
• ghe > enterprise reset (GitHub Enterprise only)