{"adoption": {"forks": 712, "observed_at": "2026-08-28T04:11:14.636630+00:00", "stars": 15999}, "canonical_url": "https://ross.abutalabs.com/products/hammerspoon", "card": {"archived": false, "artifact_type": "application", "description": "Staggeringly powerful macOS desktop automation with Lua", "domain": ["developer-tools", "desktop-applications"], "enriched": true, "function": ["developer-tools", "workflow-automation", "plugin-system", "gui"], "health_score": 92, "homepage": "http://www.hammerspoon.org", "language": "Objective-C", "license": "MIT", "license_family": "permissive", "maturity": "active", "member_repos": ["Hammerspoon/hammerspoon"], "name": "Hammerspoon/hammerspoon", "platform": ["lua"], "pushed_at": "2026-07-08T21:13:24+00:00", "repo": "Hammerspoon/hammerspoon", "stars": 15999, "tags": ["lua-scripting", "desktop-automation", "window-management", "keyboard-shortcuts", "hotkeys", "accessibility-api", "spoons", "automation", "macos", "desktop"], "topics": ["macos", "objective-c", "lua", "hammerspoon", "osx", "automation", "mjolnir", "irc"], "urls": [], "use_cases": ["automate window management on macOS", "bind custom keyboard shortcuts to system actions", "run scripts when wifi connects to a network", "show alerts when battery drops below a threshold", "control mouse and keyboard events programmatically", "watch for application launch and quit events", "script macOS accessibility APIs"], "what_it_is": "Hammerspoon is a macOS desktop automation application that bridges the operating system's APIs to a Lua scripting engine. Users write Lua configuration scripts to control windows, applications, keyboard/mouse events, and many other system functions.", "when_to_avoid": ["you need a no-code automation tool with a GUI", "you want cross-platform automation beyond macOS", "you are not comfortable writing and maintaining Lua scripts", "you only need simple app launching that Spotlight already covers"], "when_to_choose": ["you want deep, scriptable automation of macOS with Lua", "you need fine-grained control over windows, hotkeys, and system events", "you prefer a free, open-source alternative to paid Mac automation tools", "you want to extend functionality with community Spoons or your own modules"]}, "data_as_of": "2026-08-30T08:39:29.467469+00:00", "members": [{"path": "/products/hammerspoon", "repo": "Hammerspoon/hammerspoon", "role": "main", "score": 82}], "provenance": {"archived": {"kind": "observed", "observed_at": "2026-08-28T04:11:14.636630+00:00", "source": "github"}, "artifact_type": {"confidence": null, "enriched_at": "2026-08-29T17:05:17.553562+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "0141bb95d17645dca45b87872dacff1155c9bb2e8222938fb67efba4a550ca22", "fetched_at": "2026-08-28T04:11:14.636630+00:00", "kind": "readme", "missing": false, "url": "https://github.com/Hammerspoon/hammerspoon"}, {"content_hash": "3e96f7b0bdc92c78e015226dd53aa0d0e5b52983572916eaee8f44cece75c69d", "fetched_at": "2026-08-29T08:03:07.148576+00:00", "kind": "homepage", "missing": false, "url": "http://www.hammerspoon.org"}, {"content_hash": "d9c64a687dc90474dc494cde6ff0ed1b281e30a0d547e31d7125a0f593f3706d", "fetched_at": "2026-08-29T08:03:07.185237+00:00", "kind": "site_page", "missing": false, "url": "http://www.hammerspoon.org/docs/index.html"}, {"content_hash": "2d782bfa5bc7c868034ebafe6bfba44e5375741152ccdcc225dd1057f6c59c01", "fetched_at": "2026-08-29T08:03:07.233467+00:00", "kind": "site_page", "missing": false, "url": "http://www.hammerspoon.org/docs"}, {"content_hash": "273743d6bfe004ba3f5cc3a290d4830af532e99195df345e231329ff150e372b", "fetched_at": "2026-08-29T08:03:07.152162+00:00", "kind": "site_page", "missing": false, "url": "http://www.hammerspoon.org/faq"}], "taxonomy_version": 1}, "description": {"kind": "observed", "observed_at": "2026-08-28T04:11:14.636630+00:00", "source": "github"}, "domain": {"confidence": null, "enriched_at": "2026-08-29T17:05:17.553562+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "0141bb95d17645dca45b87872dacff1155c9bb2e8222938fb67efba4a550ca22", "fetched_at": "2026-08-28T04:11:14.636630+00:00", "kind": "readme", "missing": false, "url": "https://github.com/Hammerspoon/hammerspoon"}, {"content_hash": "3e96f7b0bdc92c78e015226dd53aa0d0e5b52983572916eaee8f44cece75c69d", "fetched_at": "2026-08-29T08:03:07.148576+00:00", "kind": "homepage", "missing": false, "url": "http://www.hammerspoon.org"}, {"content_hash": "d9c64a687dc90474dc494cde6ff0ed1b281e30a0d547e31d7125a0f593f3706d", "fetched_at": "2026-08-29T08:03:07.185237+00:00", "kind": "site_page", "missing": false, "url": "http://www.hammerspoon.org/docs/index.html"}, {"content_hash": "2d782bfa5bc7c868034ebafe6bfba44e5375741152ccdcc225dd1057f6c59c01", "fetched_at": "2026-08-29T08:03:07.233467+00:00", "kind": "site_page", "missing": false, "url": "http://www.hammerspoon.org/docs"}, {"content_hash": "273743d6bfe004ba3f5cc3a290d4830af532e99195df345e231329ff150e372b", "fetched_at": "2026-08-29T08:03:07.152162+00:00", "kind": "site_page", "missing": false, "url": "http://www.hammerspoon.org/faq"}], "taxonomy_version": 1}, "enriched": {"inputs": [], "kind": "computed", "method": "enrichment_status"}, "function": {"confidence": null, "enriched_at": "2026-08-29T17:05:17.553562+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "0141bb95d17645dca45b87872dacff1155c9bb2e8222938fb67efba4a550ca22", "fetched_at": "2026-08-28T04:11:14.636630+00:00", "kind": "readme", "missing": false, "url": "https://github.com/Hammerspoon/hammerspoon"}, {"content_hash": "3e96f7b0bdc92c78e015226dd53aa0d0e5b52983572916eaee8f44cece75c69d", "fetched_at": "2026-08-29T08:03:07.148576+00:00", "kind": "homepage", "missing": false, "url": "http://www.hammerspoon.org"}, {"content_hash": "d9c64a687dc90474dc494cde6ff0ed1b281e30a0d547e31d7125a0f593f3706d", "fetched_at": "2026-08-29T08:03:07.185237+00:00", "kind": "site_page", "missing": false, "url": "http://www.hammerspoon.org/docs/index.html"}, {"content_hash": "2d782bfa5bc7c868034ebafe6bfba44e5375741152ccdcc225dd1057f6c59c01", "fetched_at": "2026-08-29T08:03:07.233467+00:00", "kind": "site_page", "missing": false, "url": "http://www.hammerspoon.org/docs"}, {"content_hash": "273743d6bfe004ba3f5cc3a290d4830af532e99195df345e231329ff150e372b", "fetched_at": "2026-08-29T08:03:07.152162+00:00", "kind": "site_page", "missing": false, "url": "http://www.hammerspoon.org/faq"}], "taxonomy_version": 1}, "health_score": {"inputs": ["days_since_push", "days_since_release", "archived"], "kind": "computed", "method": "health_v1"}, "homepage": {"kind": "observed", "observed_at": "2026-08-28T04:11:14.636630+00:00", "source": "github"}, "language": {"kind": "observed", "observed_at": "2026-08-28T04:11:14.636630+00:00", "source": "github"}, "license": {"kind": "observed", "observed_at": "2026-08-28T04:11:14.636630+00:00", "source": "github"}, "license_family": {"inputs": ["license"], "kind": "computed", "method": "license_family"}, "maturity": {"confidence": null, "enriched_at": "2026-08-29T17:05:17.553562+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "0141bb95d17645dca45b87872dacff1155c9bb2e8222938fb67efba4a550ca22", "fetched_at": "2026-08-28T04:11:14.636630+00:00", "kind": "readme", "missing": false, "url": "https://github.com/Hammerspoon/hammerspoon"}, {"content_hash": "3e96f7b0bdc92c78e015226dd53aa0d0e5b52983572916eaee8f44cece75c69d", "fetched_at": "2026-08-29T08:03:07.148576+00:00", "kind": "homepage", "missing": false, "url": "http://www.hammerspoon.org"}, {"content_hash": "d9c64a687dc90474dc494cde6ff0ed1b281e30a0d547e31d7125a0f593f3706d", "fetched_at": "2026-08-29T08:03:07.185237+00:00", "kind": "site_page", "missing": false, "url": "http://www.hammerspoon.org/docs/index.html"}, {"content_hash": "2d782bfa5bc7c868034ebafe6bfba44e5375741152ccdcc225dd1057f6c59c01", "fetched_at": "2026-08-29T08:03:07.233467+00:00", "kind": "site_page", "missing": false, "url": "http://www.hammerspoon.org/docs"}, {"content_hash": "273743d6bfe004ba3f5cc3a290d4830af532e99195df345e231329ff150e372b", "fetched_at": "2026-08-29T08:03:07.152162+00:00", "kind": "site_page", "missing": false, "url": "http://www.hammerspoon.org/faq"}], "taxonomy_version": 1}, "member_repos": {"kind": "observed", "observed_at": "2026-08-28T04:11:14.636630+00:00", "source": "github"}, "name": {"kind": "observed", "observed_at": "2026-08-28T04:11:14.636630+00:00", "source": "github"}, "platform": {"confidence": null, "enriched_at": "2026-08-29T17:05:17.553562+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "0141bb95d17645dca45b87872dacff1155c9bb2e8222938fb67efba4a550ca22", "fetched_at": "2026-08-28T04:11:14.636630+00:00", "kind": "readme", "missing": false, "url": "https://github.com/Hammerspoon/hammerspoon"}, {"content_hash": "3e96f7b0bdc92c78e015226dd53aa0d0e5b52983572916eaee8f44cece75c69d", "fetched_at": "2026-08-29T08:03:07.148576+00:00", "kind": "homepage", "missing": false, "url": "http://www.hammerspoon.org"}, {"content_hash": "d9c64a687dc90474dc494cde6ff0ed1b281e30a0d547e31d7125a0f593f3706d", "fetched_at": "2026-08-29T08:03:07.185237+00:00", "kind": "site_page", "missing": false, "url": "http://www.hammerspoon.org/docs/index.html"}, {"content_hash": "2d782bfa5bc7c868034ebafe6bfba44e5375741152ccdcc225dd1057f6c59c01", "fetched_at": "2026-08-29T08:03:07.233467+00:00", "kind": "site_page", "missing": false, "url": "http://www.hammerspoon.org/docs"}, {"content_hash": "273743d6bfe004ba3f5cc3a290d4830af532e99195df345e231329ff150e372b", "fetched_at": "2026-08-29T08:03:07.152162+00:00", "kind": "site_page", "missing": false, "url": "http://www.hammerspoon.org/faq"}], "taxonomy_version": 1}, "pushed_at": {"kind": "observed", "observed_at": "2026-08-28T04:11:14.636630+00:00", "source": "github"}, "repo": {"kind": "observed", "observed_at": "2026-08-28T04:11:14.636630+00:00", "source": "github"}, "stars": {"kind": "observed", "observed_at": "2026-08-28T04:11:14.636630+00:00", "source": "github"}, "tags": {"confidence": null, "enriched_at": "2026-08-29T17:05:17.553562+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "0141bb95d17645dca45b87872dacff1155c9bb2e8222938fb67efba4a550ca22", "fetched_at": "2026-08-28T04:11:14.636630+00:00", "kind": "readme", "missing": false, "url": "https://github.com/Hammerspoon/hammerspoon"}, {"content_hash": "3e96f7b0bdc92c78e015226dd53aa0d0e5b52983572916eaee8f44cece75c69d", "fetched_at": "2026-08-29T08:03:07.148576+00:00", "kind": "homepage", "missing": false, "url": "http://www.hammerspoon.org"}, {"content_hash": "d9c64a687dc90474dc494cde6ff0ed1b281e30a0d547e31d7125a0f593f3706d", "fetched_at": "2026-08-29T08:03:07.185237+00:00", "kind": "site_page", "missing": false, "url": "http://www.hammerspoon.org/docs/index.html"}, {"content_hash": "2d782bfa5bc7c868034ebafe6bfba44e5375741152ccdcc225dd1057f6c59c01", "fetched_at": "2026-08-29T08:03:07.233467+00:00", "kind": "site_page", "missing": false, "url": "http://www.hammerspoon.org/docs"}, {"content_hash": "273743d6bfe004ba3f5cc3a290d4830af532e99195df345e231329ff150e372b", "fetched_at": "2026-08-29T08:03:07.152162+00:00", "kind": "site_page", "missing": false, "url": "http://www.hammerspoon.org/faq"}], "taxonomy_version": 1}, "topics": {"kind": "observed", "observed_at": "2026-08-28T04:11:14.636630+00:00", "source": "github"}, "urls": {"kind": "observed", "observed_at": "2026-08-28T04:11:14.636630+00:00", "source": "github"}, "use_cases": {"confidence": null, "enriched_at": "2026-08-29T17:05:17.553562+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "0141bb95d17645dca45b87872dacff1155c9bb2e8222938fb67efba4a550ca22", "fetched_at": "2026-08-28T04:11:14.636630+00:00", "kind": "readme", "missing": false, "url": "https://github.com/Hammerspoon/hammerspoon"}, {"content_hash": "3e96f7b0bdc92c78e015226dd53aa0d0e5b52983572916eaee8f44cece75c69d", "fetched_at": "2026-08-29T08:03:07.148576+00:00", "kind": "homepage", "missing": false, "url": "http://www.hammerspoon.org"}, {"content_hash": "d9c64a687dc90474dc494cde6ff0ed1b281e30a0d547e31d7125a0f593f3706d", "fetched_at": "2026-08-29T08:03:07.185237+00:00", "kind": "site_page", "missing": false, "url": "http://www.hammerspoon.org/docs/index.html"}, {"content_hash": "2d782bfa5bc7c868034ebafe6bfba44e5375741152ccdcc225dd1057f6c59c01", "fetched_at": "2026-08-29T08:03:07.233467+00:00", "kind": "site_page", "missing": false, "url": "http://www.hammerspoon.org/docs"}, {"content_hash": "273743d6bfe004ba3f5cc3a290d4830af532e99195df345e231329ff150e372b", "fetched_at": "2026-08-29T08:03:07.152162+00:00", "kind": "site_page", "missing": false, "url": "http://www.hammerspoon.org/faq"}], "taxonomy_version": 1}, "what_it_is": {"confidence": null, "enriched_at": "2026-08-29T17:05:17.553562+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "0141bb95d17645dca45b87872dacff1155c9bb2e8222938fb67efba4a550ca22", "fetched_at": "2026-08-28T04:11:14.636630+00:00", "kind": "readme", "missing": false, "url": "https://github.com/Hammerspoon/hammerspoon"}, {"content_hash": "3e96f7b0bdc92c78e015226dd53aa0d0e5b52983572916eaee8f44cece75c69d", "fetched_at": "2026-08-29T08:03:07.148576+00:00", "kind": "homepage", "missing": false, "url": "http://www.hammerspoon.org"}, {"content_hash": "d9c64a687dc90474dc494cde6ff0ed1b281e30a0d547e31d7125a0f593f3706d", "fetched_at": "2026-08-29T08:03:07.185237+00:00", "kind": "site_page", "missing": false, "url": "http://www.hammerspoon.org/docs/index.html"}, {"content_hash": "2d782bfa5bc7c868034ebafe6bfba44e5375741152ccdcc225dd1057f6c59c01", "fetched_at": "2026-08-29T08:03:07.233467+00:00", "kind": "site_page", "missing": false, "url": "http://www.hammerspoon.org/docs"}, {"content_hash": "273743d6bfe004ba3f5cc3a290d4830af532e99195df345e231329ff150e372b", "fetched_at": "2026-08-29T08:03:07.152162+00:00", "kind": "site_page", "missing": false, "url": "http://www.hammerspoon.org/faq"}], "taxonomy_version": 1}, "when_to_avoid": {"confidence": null, "enriched_at": "2026-08-29T17:05:17.553562+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "0141bb95d17645dca45b87872dacff1155c9bb2e8222938fb67efba4a550ca22", "fetched_at": "2026-08-28T04:11:14.636630+00:00", "kind": "readme", "missing": false, "url": "https://github.com/Hammerspoon/hammerspoon"}, {"content_hash": "3e96f7b0bdc92c78e015226dd53aa0d0e5b52983572916eaee8f44cece75c69d", "fetched_at": "2026-08-29T08:03:07.148576+00:00", "kind": "homepage", "missing": false, "url": "http://www.hammerspoon.org"}, {"content_hash": "d9c64a687dc90474dc494cde6ff0ed1b281e30a0d547e31d7125a0f593f3706d", "fetched_at": "2026-08-29T08:03:07.185237+00:00", "kind": "site_page", "missing": false, "url": "http://www.hammerspoon.org/docs/index.html"}, {"content_hash": "2d782bfa5bc7c868034ebafe6bfba44e5375741152ccdcc225dd1057f6c59c01", "fetched_at": "2026-08-29T08:03:07.233467+00:00", "kind": "site_page", "missing": false, "url": "http://www.hammerspoon.org/docs"}, {"content_hash": "273743d6bfe004ba3f5cc3a290d4830af532e99195df345e231329ff150e372b", "fetched_at": "2026-08-29T08:03:07.152162+00:00", "kind": "site_page", "missing": false, "url": "http://www.hammerspoon.org/faq"}], "taxonomy_version": 1}, "when_to_choose": {"confidence": null, "enriched_at": "2026-08-29T17:05:17.553562+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "0141bb95d17645dca45b87872dacff1155c9bb2e8222938fb67efba4a550ca22", "fetched_at": "2026-08-28T04:11:14.636630+00:00", "kind": "readme", "missing": false, "url": "https://github.com/Hammerspoon/hammerspoon"}, {"content_hash": "3e96f7b0bdc92c78e015226dd53aa0d0e5b52983572916eaee8f44cece75c69d", "fetched_at": "2026-08-29T08:03:07.148576+00:00", "kind": "homepage", "missing": false, "url": "http://www.hammerspoon.org"}, {"content_hash": "d9c64a687dc90474dc494cde6ff0ed1b281e30a0d547e31d7125a0f593f3706d", "fetched_at": "2026-08-29T08:03:07.185237+00:00", "kind": "site_page", "missing": false, "url": "http://www.hammerspoon.org/docs/index.html"}, {"content_hash": "2d782bfa5bc7c868034ebafe6bfba44e5375741152ccdcc225dd1057f6c59c01", "fetched_at": "2026-08-29T08:03:07.233467+00:00", "kind": "site_page", "missing": false, "url": "http://www.hammerspoon.org/docs"}, {"content_hash": "273743d6bfe004ba3f5cc3a290d4830af532e99195df345e231329ff150e372b", "fetched_at": "2026-08-29T08:03:07.152162+00:00", "kind": "site_page", "missing": false, "url": "http://www.hammerspoon.org/faq"}], "taxonomy_version": 1}}, "score": {"components": {"activity": 91, "longevity": 100, "rhythm": 60}, "computed_at": "2026-09-03T02:20:16.233290+00:00", "flags": [], "formula": "round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)", "inputs": {"age_days": 4347, "days_push": 56, "days_rel": 188, "gap_med": 63, "n_releases_24m": 2}, "score": 82, "version": 2}, "staleness": {"enrichment_outdated": false, "low_confidence": false, "scrape_days": 9, "stale_scrape": false}}