🦊 Alfred workflow to search GitLab issues and merge requests.
- Configure as many projects as you want under a custom command.
- Open the selected issue or merge request in your browser.
- Filter by label by prefixing your search with
~. - Filter by author by prefixing your search with
@. - Use ⇧ to instead copy the rich text URL to clipboard.
- Blazingly fast 🤸.
Grab the latest release from the releases page.
Because the release contains an executable binary later versions of macOS will mark it as untrusted and Alfred won't be able to execute it. You can run the following to explicitly trust the release before installing to Alfred.
xattr -c ~/Downloads/gitlab-*-apple-darwin.alfredworkflowThis workflow is written in Rust, so to install it from source you will first
need to install Rust and Cargo using rustup. Then install
powerpack. Then you can run the
following to build an .alfredworkflow file.
git clone https://github.com/rossmacarthur/gitlab.alfredworkflow.git
cd gitlab.alfredworkflow
powerpack packageThe release will be available at target/workflow/gitlab.alfredworkflow.
| Name | Example | Description |
|---|---|---|
| GITLAB_TOKEN | glpat-S-of2... |
Personal access token |
| GITLAB_USER | rossmacarthur | (Optional) Your GitLab username. Used to sort items |
| GITLAB_SHORTCUTS | true | (Optional) Adds slash shortcuts like /new and /boards |
The GITLAB_TOKEN environment variable is required. You can create it using
this link.
It only needs the read_api permission.
Any environment variable prefixed with GITLAB_ISSUES_ or
GITLAB_MERGE_REQUESTS_ defines a workflow command that will list the issues
or merge requests for the provided project respectively. The name of the command
should follow the prefix. For example to get the command to list issues on the
iTerm2 repository like in the screenshot above you would set the following
environment variable.
| Name | Value |
|---|---|
| GITLAB_ISSUES_ITERM2 | gnachman/iterm2 |
You can specify as many commands as you want.
This project is distributed under the terms of both the MIT license and the Apache License (Version 2.0).
See LICENSE-APACHE and LICENSE-MIT for details.