Allow easy user configurations for your Alfred workflows

Usage no npm install needed!

<script type="module">
  import alfredConfig from '';


alfred-config Build Status

Allow easy user configurations for your Alfred workflows


$ npm install --save alfred-config


Add the alfred-config command as postinstall script of your Alfred package.

    "name": "alfred-unicorn",
    "scripts": {
        "postinstall": "alfred-config"

After installing the alfred-unicorn package, the system will open the text editor and allows your user to change the provided workflow configuration.

Workflow configuration

A workflow configuration is defined by a JSON file which allows comments.

    // GitHub API key
    "apiKey": "",

    // Throttling rate (requests per second)
    "throttling": 50,

    // GitHub user information
    "user": {
        "name": "",
        "email": ""

You can provide defaults as well which the user can change after installing the package.

When your workflow evolves over time, you can add more properties or even remove deprecated ones. It will automatically merge the old user provided configuration with the new workflow configuration, removing unused properties.


  • alfy - Create Alfred workflows with ease


MIT © Sam Verschueren