Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/lukewaite/alfred-gitlab

A GitLab workflow for Alfred 3
https://github.com/lukewaite/alfred-gitlab

alfred alfred-workflow gitlab

Last synced: about 1 month ago
JSON representation

A GitLab workflow for Alfred 3

Awesome Lists containing this project

README

        

# Alfred Gitlab

Quickly navigate to GitLab projects in [Alfred 3][alfred].

![][sample]

## Setup and Usage
* Generate a GitLab personal access token (https://gitlab.com/profile/personal_access_tokens) then run `glsetkey `
* (Optionally) Tell it where the GitLab API you want to connect to is by running `glseturl https:///api/v4/projects`
* Defaults to GitLab.com's public API
* search for projects with `gl `

### Sub-Page Navigation
![][sub-page]
After selecting a repository, you are prompted with a page to navigate to. You can disable this behaviour
by setting the `quick_open` workflow variable to `true`.

See the Alfred documentation on [Workflow variables][wf-vars] for more information on how to configure workflow variables.

## Notes
By default, we will only show projects which you are a member of.

## TODOs
* Optionally, allow you to search for non-membership repos
* Add alfred-workflow updater notifications
* Clean up

# Thanks, License, Copyright

- The [Alfred-Workflow][alfred-workflow] library is used heavily, and it's wonderful documentation was key in building the plugin.
- The GitLab icon is used, care of GitLab.

All other code/media are released under the [MIT Licence][license].

[alfred]: http://www.alfredapp.com/
[alfred-workflow]: http://www.deanishe.net/alfred-workflow/
[wf-vars]: https://www.alfredapp.com/help/workflows/advanced/variables/
[license]: src/LICENSE.txt
[sample]: https://raw.github.com/lukewaite/alfred-gitlab/master/docs/sample.png
[sub-page]: https://raw.github.com/lukewaite/alfred-gitlab/master/docs/sub-page.png