{"repo":"photon-hq/imessage-kit","free":true,"listed":false,"github":"https://github.com/photon-hq/imessage-kit","clone":"git clone https://github.com/photon-hq/imessage-kit.git","description":"A type-safe, elegant iMessage SDK for macOS with zero dependencies","language":"TypeScript","stars":1440,"topics":["ai","apple","imessage","typescript","agent","sms"],"license":"MIT","category":"chat-messaging","readme_excerpt":"@photon-ai/imessage-kit A type-safe, elegant iMessage SDK for macOS with cross-runtime support A full-featured iMessage SDK for reading , sending , and automating iMessage conversations on macOS. Perfect for building AI agents, automation tools, and chat-first applications. [!NOTE] ✨ Looking for advanced features like threaded replies, tapbacks, message editing, unsending, live typing indicators? Try Photon Spectrum About Photon Photon builds infrastructure for AI agents that operate over real communication channels. Spectrum is Photon’s open-source multi-channel agent framework, enabling AI agents to communicate through interfaces people already use—such as iMessage, SMS, email, Slack, Discord, and voice—instead of being confined to web chat. --- Features Feature Method Example --------- -------- --------- Send Text sdk.send() 01-send-text.ts Send Image sdk.send() 02-send-image.ts Send File sdk.send() 03-send-file.ts Send to Group sdk.send() 04-send-group.ts Query Messages sdk.getMessages() 05-query-messages.ts List Chats sdk.listChats() 06-list-chats.ts Real-time Watching sdk.startWatching() 07-watch-messages.ts Auto Reply onDirectMessage → sdk.send() 08-auto-reply.ts Plugin System sdk.use() 10-plugin.ts Error Handling IMessageError 11-error-handling.ts --- Quick Start Installation Basic Usage Configuration Out-of-range numeric values throw IMessageError(code: 'CONFIG') at construction — they are not silently clamped. The accepted ranges are exposed as the BOUNDS constant e","default_branch":null,"files":null,"tree":[],"storefront":"/r/photon-hq","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/photon-hq/imessage-kit/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}