{"adoption": {"forks": 129, "observed_at": "2026-08-28T04:04:45.418549+00:00", "stars": 1447}, "canonical_url": "https://ross.abutalabs.com/products/imessage-kit", "card": {"archived": false, "artifact_type": "library", "description": "A type-safe, elegant iMessage SDK for macOS with zero dependencies", "domain": ["messaging-platforms", "developer-tools", "apple-ecosystem"], "enriched": true, "function": ["sdk", "chatbot", "agent-framework", "message-queue", "workflow-automation"], "health_score": 90, "homepage": "https://photon.codes", "language": "TypeScript", "license": "MIT", "license_family": "permissive", "maturity": "active", "member_repos": ["photon-hq/imessage-kit"], "name": "photon-hq/imessage-kit", "platform": ["bun"], "pushed_at": "2026-06-08T23:18:06+00:00", "repo": "photon-hq/imessage-kit", "stars": 1447, "tags": ["imessage", "sms", "messaging-sdk", "zero-dependency", "type-safe", "auto-reply", "chat-automation", "ai-agents", "macos", "nodejs", "typescript"], "topics": ["ai", "apple", "imessage", "typescript", "agent", "sms"], "urls": [], "use_cases": ["send imessages from a script on mac", "build an ai agent that replies to imessages", "auto-reply to incoming text messages on macos", "read and query imessage history programmatically", "watch for new imessages in real time", "send images and files via imessage from node", "build a chatbot over imessage and sms"], "what_it_is": "A type-safe, zero-dependency TypeScript SDK for reading, sending, and automating iMessage conversations on macOS. It supports sending text, images, and files, querying messages, listing chats, real-time message watching, auto-replying, and a plugin system, making it suitable for building AI agents and chat-first applications.", "when_to_avoid": ["you need cross-platform messaging on Windows or Linux", "you need channels beyond iMessage/SMS like WhatsApp or Telegram (consider the vendor's Spectrum framework instead)", "you need advanced iMessage features like tapbacks, threaded replies, or message editing"], "when_to_choose": ["you need to send, read, or automate iMessage on macOS from TypeScript/JavaScript", "you want a zero-dependency SDK with type safety for messaging automation", "you are building AI agents that communicate over iMessage or SMS"]}, "data_as_of": "2026-08-30T08:39:29.467469+00:00", "members": [{"path": "/products/imessage-kit", "repo": "photon-hq/imessage-kit", "role": "main", "score": 71}], "provenance": {"archived": {"kind": "observed", "observed_at": "2026-08-28T04:04:45.418549+00:00", "source": "github"}, "artifact_type": {"confidence": null, "enriched_at": "2026-08-30T04:36:07.756988+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "1b012f1ace77eaacb8d765aad2e20b230be11c926bfefaa713efee6d6afb2703", "fetched_at": "2026-08-28T04:04:45.418549+00:00", "kind": "readme", "missing": false, "url": "https://github.com/photon-hq/imessage-kit"}, {"content_hash": "b7d22621a09a9d93295557cb05639a133798781975e0b9065edd392f66f7e3f9", "fetched_at": "2026-08-29T11:46:10.050363+00:00", "kind": "homepage", "missing": false, "url": "https://photon.codes"}, {"content_hash": "b0a9dd22d5b3f518a8cd1ecbfba5e3470aa9018b0aae121406ed11874f8dd14d", "fetched_at": "2026-08-29T11:46:10.062103+00:00", "kind": "site_page", "missing": false, "url": "https://docs.photon.codes"}, {"content_hash": "7ad035be5a4489fe431894281c25ec5a0cd4ab8e4feb9c188ad83742eecb3ae1", "fetched_at": "2026-08-29T11:46:10.059859+00:00", "kind": "site_page", "missing": false, "url": "https://photon.codes/pricing"}], "taxonomy_version": 1}, "description": {"kind": "observed", "observed_at": "2026-08-28T04:04:45.418549+00:00", "source": "github"}, "domain": {"confidence": null, "enriched_at": "2026-08-30T04:36:07.756988+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "1b012f1ace77eaacb8d765aad2e20b230be11c926bfefaa713efee6d6afb2703", "fetched_at": "2026-08-28T04:04:45.418549+00:00", "kind": "readme", "missing": false, "url": "https://github.com/photon-hq/imessage-kit"}, {"content_hash": "b7d22621a09a9d93295557cb05639a133798781975e0b9065edd392f66f7e3f9", "fetched_at": "2026-08-29T11:46:10.050363+00:00", "kind": "homepage", "missing": false, "url": "https://photon.codes"}, {"content_hash": "b0a9dd22d5b3f518a8cd1ecbfba5e3470aa9018b0aae121406ed11874f8dd14d", "fetched_at": "2026-08-29T11:46:10.062103+00:00", "kind": "site_page", "missing": false, "url": "https://docs.photon.codes"}, {"content_hash": "7ad035be5a4489fe431894281c25ec5a0cd4ab8e4feb9c188ad83742eecb3ae1", "fetched_at": "2026-08-29T11:46:10.059859+00:00", "kind": "site_page", "missing": false, "url": "https://photon.codes/pricing"}], "taxonomy_version": 1}, "enriched": {"inputs": [], "kind": "computed", "method": "enrichment_status"}, "function": {"confidence": null, "enriched_at": "2026-08-30T04:36:07.756988+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "1b012f1ace77eaacb8d765aad2e20b230be11c926bfefaa713efee6d6afb2703", "fetched_at": "2026-08-28T04:04:45.418549+00:00", "kind": "readme", "missing": false, "url": "https://github.com/photon-hq/imessage-kit"}, {"content_hash": "b7d22621a09a9d93295557cb05639a133798781975e0b9065edd392f66f7e3f9", "fetched_at": "2026-08-29T11:46:10.050363+00:00", "kind": "homepage", "missing": false, "url": "https://photon.codes"}, {"content_hash": "b0a9dd22d5b3f518a8cd1ecbfba5e3470aa9018b0aae121406ed11874f8dd14d", "fetched_at": "2026-08-29T11:46:10.062103+00:00", "kind": "site_page", "missing": false, "url": "https://docs.photon.codes"}, {"content_hash": "7ad035be5a4489fe431894281c25ec5a0cd4ab8e4feb9c188ad83742eecb3ae1", "fetched_at": "2026-08-29T11:46:10.059859+00:00", "kind": "site_page", "missing": false, "url": "https://photon.codes/pricing"}], "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:04:45.418549+00:00", "source": "github"}, "language": {"kind": "observed", "observed_at": "2026-08-28T04:04:45.418549+00:00", "source": "github"}, "license": {"kind": "observed", "observed_at": "2026-08-28T04:04:45.418549+00:00", "source": "github"}, "license_family": {"inputs": ["license"], "kind": "computed", "method": "license_family"}, "maturity": {"confidence": null, "enriched_at": "2026-08-30T04:36:07.756988+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "1b012f1ace77eaacb8d765aad2e20b230be11c926bfefaa713efee6d6afb2703", "fetched_at": "2026-08-28T04:04:45.418549+00:00", "kind": "readme", "missing": false, "url": "https://github.com/photon-hq/imessage-kit"}, {"content_hash": "b7d22621a09a9d93295557cb05639a133798781975e0b9065edd392f66f7e3f9", "fetched_at": "2026-08-29T11:46:10.050363+00:00", "kind": "homepage", "missing": false, "url": "https://photon.codes"}, {"content_hash": "b0a9dd22d5b3f518a8cd1ecbfba5e3470aa9018b0aae121406ed11874f8dd14d", "fetched_at": "2026-08-29T11:46:10.062103+00:00", "kind": "site_page", "missing": false, "url": "https://docs.photon.codes"}, {"content_hash": "7ad035be5a4489fe431894281c25ec5a0cd4ab8e4feb9c188ad83742eecb3ae1", "fetched_at": "2026-08-29T11:46:10.059859+00:00", "kind": "site_page", "missing": false, "url": "https://photon.codes/pricing"}], "taxonomy_version": 1}, "member_repos": {"kind": "observed", "observed_at": "2026-08-28T04:04:45.418549+00:00", "source": "github"}, "name": {"kind": "observed", "observed_at": "2026-08-28T04:04:45.418549+00:00", "source": "github"}, "platform": {"confidence": null, "enriched_at": "2026-08-30T04:36:07.756988+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "1b012f1ace77eaacb8d765aad2e20b230be11c926bfefaa713efee6d6afb2703", "fetched_at": "2026-08-28T04:04:45.418549+00:00", "kind": "readme", "missing": false, "url": "https://github.com/photon-hq/imessage-kit"}, {"content_hash": "b7d22621a09a9d93295557cb05639a133798781975e0b9065edd392f66f7e3f9", "fetched_at": "2026-08-29T11:46:10.050363+00:00", "kind": "homepage", "missing": false, "url": "https://photon.codes"}, {"content_hash": "b0a9dd22d5b3f518a8cd1ecbfba5e3470aa9018b0aae121406ed11874f8dd14d", "fetched_at": "2026-08-29T11:46:10.062103+00:00", "kind": "site_page", "missing": false, "url": "https://docs.photon.codes"}, {"content_hash": "7ad035be5a4489fe431894281c25ec5a0cd4ab8e4feb9c188ad83742eecb3ae1", "fetched_at": "2026-08-29T11:46:10.059859+00:00", "kind": "site_page", "missing": false, "url": "https://photon.codes/pricing"}], "taxonomy_version": 1}, "pushed_at": {"kind": "observed", "observed_at": "2026-08-28T04:04:45.418549+00:00", "source": "github"}, "repo": {"kind": "observed", "observed_at": "2026-08-28T04:04:45.418549+00:00", "source": "github"}, "stars": {"kind": "observed", "observed_at": "2026-08-28T04:04:45.418549+00:00", "source": "github"}, "tags": {"confidence": null, "enriched_at": "2026-08-30T04:36:07.756988+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "1b012f1ace77eaacb8d765aad2e20b230be11c926bfefaa713efee6d6afb2703", "fetched_at": "2026-08-28T04:04:45.418549+00:00", "kind": "readme", "missing": false, "url": "https://github.com/photon-hq/imessage-kit"}, {"content_hash": "b7d22621a09a9d93295557cb05639a133798781975e0b9065edd392f66f7e3f9", "fetched_at": "2026-08-29T11:46:10.050363+00:00", "kind": "homepage", "missing": false, "url": "https://photon.codes"}, {"content_hash": "b0a9dd22d5b3f518a8cd1ecbfba5e3470aa9018b0aae121406ed11874f8dd14d", "fetched_at": "2026-08-29T11:46:10.062103+00:00", "kind": "site_page", "missing": false, "url": "https://docs.photon.codes"}, {"content_hash": "7ad035be5a4489fe431894281c25ec5a0cd4ab8e4feb9c188ad83742eecb3ae1", "fetched_at": "2026-08-29T11:46:10.059859+00:00", "kind": "site_page", "missing": false, "url": "https://photon.codes/pricing"}], "taxonomy_version": 1}, "topics": {"kind": "observed", "observed_at": "2026-08-28T04:04:45.418549+00:00", "source": "github"}, "urls": {"kind": "observed", "observed_at": "2026-08-28T04:04:45.418549+00:00", "source": "github"}, "use_cases": {"confidence": null, "enriched_at": "2026-08-30T04:36:07.756988+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "1b012f1ace77eaacb8d765aad2e20b230be11c926bfefaa713efee6d6afb2703", "fetched_at": "2026-08-28T04:04:45.418549+00:00", "kind": "readme", "missing": false, "url": "https://github.com/photon-hq/imessage-kit"}, {"content_hash": "b7d22621a09a9d93295557cb05639a133798781975e0b9065edd392f66f7e3f9", "fetched_at": "2026-08-29T11:46:10.050363+00:00", "kind": "homepage", "missing": false, "url": "https://photon.codes"}, {"content_hash": "b0a9dd22d5b3f518a8cd1ecbfba5e3470aa9018b0aae121406ed11874f8dd14d", "fetched_at": "2026-08-29T11:46:10.062103+00:00", "kind": "site_page", "missing": false, "url": "https://docs.photon.codes"}, {"content_hash": "7ad035be5a4489fe431894281c25ec5a0cd4ab8e4feb9c188ad83742eecb3ae1", "fetched_at": "2026-08-29T11:46:10.059859+00:00", "kind": "site_page", "missing": false, "url": "https://photon.codes/pricing"}], "taxonomy_version": 1}, "what_it_is": {"confidence": null, "enriched_at": "2026-08-30T04:36:07.756988+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "1b012f1ace77eaacb8d765aad2e20b230be11c926bfefaa713efee6d6afb2703", "fetched_at": "2026-08-28T04:04:45.418549+00:00", "kind": "readme", "missing": false, "url": "https://github.com/photon-hq/imessage-kit"}, {"content_hash": "b7d22621a09a9d93295557cb05639a133798781975e0b9065edd392f66f7e3f9", "fetched_at": "2026-08-29T11:46:10.050363+00:00", "kind": "homepage", "missing": false, "url": "https://photon.codes"}, {"content_hash": "b0a9dd22d5b3f518a8cd1ecbfba5e3470aa9018b0aae121406ed11874f8dd14d", "fetched_at": "2026-08-29T11:46:10.062103+00:00", "kind": "site_page", "missing": false, "url": "https://docs.photon.codes"}, {"content_hash": "7ad035be5a4489fe431894281c25ec5a0cd4ab8e4feb9c188ad83742eecb3ae1", "fetched_at": "2026-08-29T11:46:10.059859+00:00", "kind": "site_page", "missing": false, "url": "https://photon.codes/pricing"}], "taxonomy_version": 1}, "when_to_avoid": {"confidence": null, "enriched_at": "2026-08-30T04:36:07.756988+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "1b012f1ace77eaacb8d765aad2e20b230be11c926bfefaa713efee6d6afb2703", "fetched_at": "2026-08-28T04:04:45.418549+00:00", "kind": "readme", "missing": false, "url": "https://github.com/photon-hq/imessage-kit"}, {"content_hash": "b7d22621a09a9d93295557cb05639a133798781975e0b9065edd392f66f7e3f9", "fetched_at": "2026-08-29T11:46:10.050363+00:00", "kind": "homepage", "missing": false, "url": "https://photon.codes"}, {"content_hash": "b0a9dd22d5b3f518a8cd1ecbfba5e3470aa9018b0aae121406ed11874f8dd14d", "fetched_at": "2026-08-29T11:46:10.062103+00:00", "kind": "site_page", "missing": false, "url": "https://docs.photon.codes"}, {"content_hash": "7ad035be5a4489fe431894281c25ec5a0cd4ab8e4feb9c188ad83742eecb3ae1", "fetched_at": "2026-08-29T11:46:10.059859+00:00", "kind": "site_page", "missing": false, "url": "https://photon.codes/pricing"}], "taxonomy_version": 1}, "when_to_choose": {"confidence": null, "enriched_at": "2026-08-30T04:36:07.756988+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "1b012f1ace77eaacb8d765aad2e20b230be11c926bfefaa713efee6d6afb2703", "fetched_at": "2026-08-28T04:04:45.418549+00:00", "kind": "readme", "missing": false, "url": "https://github.com/photon-hq/imessage-kit"}, {"content_hash": "b7d22621a09a9d93295557cb05639a133798781975e0b9065edd392f66f7e3f9", "fetched_at": "2026-08-29T11:46:10.050363+00:00", "kind": "homepage", "missing": false, "url": "https://photon.codes"}, {"content_hash": "b0a9dd22d5b3f518a8cd1ecbfba5e3470aa9018b0aae121406ed11874f8dd14d", "fetched_at": "2026-08-29T11:46:10.062103+00:00", "kind": "site_page", "missing": false, "url": "https://docs.photon.codes"}, {"content_hash": "7ad035be5a4489fe431894281c25ec5a0cd4ab8e4feb9c188ad83742eecb3ae1", "fetched_at": "2026-08-29T11:46:10.059859+00:00", "kind": "site_page", "missing": false, "url": "https://photon.codes/pricing"}], "taxonomy_version": 1}}, "score": {"components": {"activity": 86, "longevity": 22, "rhythm": 80}, "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": 319, "days_push": 86, "days_rel": 135, "gap_med": 5, "n_releases_24m": 12}, "score": 71, "version": 2}, "staleness": {"enrichment_outdated": false, "low_confidence": false, "scrape_days": 9, "stale_scrape": false}}