Skip to content
This repository was archived by the owner on Apr 9, 2026. It is now read-only.

Cloudstek/alfred-hugo

Hugo

CircleCI Coverage Status Open Issues npm GitHub GitHub stars

👋 Looking for a maintainer

I haven't touched a Mac in years and thus have not been able to keep developing Hugo, so it is time to archive this repository and possibly for someone to take over development.

If anyone would like to take over this project, please contact me. Otherwise, feel free to fork it!

To all that used, starred or contributed to Hugo, thank you so much!


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

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

Contributors

License

BSD-2-Clause license, see LICENSE.

Packages

 
 
 

Contributors