Skip to content


Repository files navigation

PHP Alfred Workflow Config

Latest Stable Version Build Status Quality Score Code Coverage Total Downloads

Easily read and write config settings for your Alfred 3 or 4 Workflow. We took care of the boring stuff for you.


composer require godbout/alfred-workflow-config


Import the class:

require 'vendor/autoload.php';

use Godbout\Alfred\Workflow\Config;

Then you can start save settings. Use dot notation for nested settings:

Config::write('language', 'english');

Config::write('', 'Guill');

Read settings:

$language = Config::read('language');

$userName = Config::read('');

You can provide a default config for your workflow. It will only be saved if no config is found:

Config::ifEmptyStartWith(['version' => 1.0, 'enabled' => true]);

Usage in your tests

Set the Alfred Workflow Data environment variable

The package uses an environment variable set by Alfred to determine where to create and store your data. If you are not using this Config class through a script that is called by Alfred (like in your tests, for example), then you need to set that environment variable. Use putenv("alfred_workflow_data=./where_you_want_to_store_alfred_data"); before writing or reading your settings.

Destroy the Config between tests

The Config class is a singleton. This allows me to provide you with a very simple and nice to use API. It works great when being used by Alfred calling your Workflow script, but not so much with testing. If you're using the Config class in your own tests, you have to destroy the singleton between each test. You can do it easily like this:

protected function tearDown(): void


This will make sure that your next test starts with a virgin Config.


There is none. We don't keep an array of settings internally, so there's no way to implement completely ArrayAccess. You could read settings through an array notation but not add a new setting, so the whole ArrayAccess implementation has been put to sleep.

Behind the scenes

  1. We create the Alfred Workflow Data folder if it doesn't exist.
  2. We create a config.json file and store the settings, well, in pretty json.
  3. We directly read and write to the config file, so even if your workflow crashes after, your settings will be saved as soon as you call the method.