# deanishe/alfred-workflow

Full-featured library for writing Alfred 3 & 4 workflows

Repository: https://github.com/deanishe/alfred-workflow
Canonical: https://ross.abutalabs.com/products/alfred-workflow
Homepage: https://www.deanishe.net/alfred-workflow/
Language: Python
License: NOASSERTION
License Family: other
Topics: alfred-workflow, alfred, python, keychain, http, caching, alfred-3, fuzzy-search, alfred3, workflow, workflows, alfred4, alfred4-workflow
Last push: 2023-01-10T14:43:04+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 4576, "days_push": 1331, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2966, forks 235 (observed 2026-08-28T04:07:32.559307+00:00)

## What it is
A Python helper library for authors of Alfred 2/3/4 workflows on macOS. It handles feedback JSON generation, fuzzy filtering, caching, settings, Keychain storage, HTTP requests, background tasks, notifications, and self-updating via GitHub releases.

## Use cases
- write an Alfred workflow in Python
- generate Alfred Script Filter JSON feedback
- add fuzzy search filtering to an Alfred workflow
- cache API responses in an Alfred workflow
- store API keys securely in the macOS Keychain
- make an Alfred workflow self-update from GitHub releases
- run background tasks from an Alfred workflow

## When to choose
- you are building a workflow for Alfred 2, 3, or 4 in Python
- you want caching, settings, Keychain, and feedback generation out of the box
- you need Alfred-like fuzzy matching with diacritic folding

## When to avoid
- you target Alfred 5 or newer features
- you write workflows in another language like Go or Swift
- you need Python 3 support - the library targets the system Python 2.7

## Facets
- artifact type: library
- maturity: maintenance
- function: http-client, caching, search-engine, logging, security, webhook
- domain: developer-tools, operating-systems
- platform: python, cli
- tags: alfred, alfred-workflow, launcher, script-filter, keychain, fuzzy-search, self-updating, macos-notifications, command-line, automation, macos

## Member repositories
- deanishe/alfred-workflow (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:32.559307+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T07:31:53.930961+00:00, confidence not recorded.
  - readme: https://github.com/deanishe/alfred-workflow (fetched 2026-08-28T04:07:32.559307+00:00, sha cf838cb43a67)
  - homepage: https://www.deanishe.net/alfred-workflow/ (fetched 2026-08-29T09:47:16.941014+00:00, sha f7e02bcb06ed)
  - site_page: https://www.deanishe.net/alfred-workflow/guide/update.html (fetched 2026-08-29T09:47:16.950208+00:00, sha 21d6eb842a16)
  - site_page: https://www.deanishe.net/alfred-workflow/installation.html (fetched 2026-08-29T09:47:16.952207+00:00, sha 1640a37d24b8)
  - site_page: https://www.deanishe.net/alfred-workflow/api/index.html (fetched 2026-08-29T09:47:16.953935+00:00, sha 354d269418a8)
  - site_page: https://www.deanishe.net/alfred-workflow/dash.html (fetched 2026-08-29T09:47:16.957211+00:00, sha 0919e166152b)
- Data as of 2026-08-30T08:39:29.467469+00:00.