Hugo is a script filter framework for your Alfred workflows. It can handle fetching and caching data, configuration storage, checking for updates and much much more. But I suppose you can use it for other purposes in your workflow as well 🤷‍♂️

Highlights

• Written in Typescript ⭐
• Well tested 👍
• Built-in cache and configuration storage
• Advanced filtering of items using Fuse.js 🔍
• Fetch (JSON) from REST API's using Axios 🌎
• Update notifications 📫

Getting started

Prerequisites

• NodeJS 10 or higher
• Alfred 4 with paid powerpack addon

Installing

Hugo can be installed using Yarn or NPM:

$ yarn add alfred-hugo

$ npm install --save alfred-hugo

Writing your script filter

Please see the docs for documentation and examples on how to use Hugo to write your script filters.

Publishing your workflow to NPM

To publish your workflow to NPM, set up the postinstall and preuninstall scripts in your package.json as follows to automatically add your workflow to Alfred.

{
  "name": "alfred-unicorn",
  "scripts": {
    "postinstall": "hugo-link",
    "preuninstall": "hugo-unlink"
  }
}

People can now install your package globally like this:

$ npm install -g my-alfred-package

Workflows using Hugo

List of Alfred workflows using Hugo.

• alfred-atom - Alfred workflow to browse and open Atom projects

Feel free to submit your own by opening an issue or submitting a pull request.

Contributing

See CONTRIBUTING for more info about how to contribute.

Authors

• Maarten de Boer

Contributors

• Marjolein Regterschot (Artwork)

License

BSD-2-Clause license, see LICENSE.