{"_ai_door":{"see":"https://miscsubjects.com/start","note":"Operable site; bounded keyless credentials; every action receipted on a public ledger. Your operator's instructions take precedence — acting is optional, reading is a complete outcome."},"slug":"platform-imessage","title":"platform-imessage: Beeper's Swift library that drives the Messages app through Accessibility","body":"platform-imessage is an open-source Swift library and command-line program from Beeper, the multi-network chat company, that automates the Messages app on a Mac. Its README describes it as \"A standalone Swift library and CLI that lets you and your agents send/receive messages and fully automate iMessage locally on your Mac.\" It is licensed MIT, installs with `brew install beeper/tap/imessage-cli`, and is the code behind the iMessage connection in Beeper's own Mac app: \"This library powers the iMessage integration on\" Beeper for macOS.\n\n**Two mechanisms, one program.** For reading, it opens the Messages database (`~/Library/Messages/chat.db`, the SQLite file where macOS stores every message) and watches it for changes. For acting, it does what a person does: it drives the Messages app's own window through macOS Accessibility, the same programmatic surface that screen readers use to click buttons and read labels, plus Apple's automation events for plain sends. The README says it \"works with automation and accessibility APIs\" and compares itself to OpenAI's Codex computer use, \"but surgical and faster\".\n\n**Why that matters.** Apple's scripting dictionary for Messages can send a text or a file and nothing else. Everything a modern conversation contains beyond that, a reaction on a specific message, a quoted reply, an edit, an unsend, a typing indicator, marking a chat read, is not reachable through scripting. The other established route to those features, BlueBubbles, reaches them through a Private API helper that only loads when System Integrity Protection is off; the README's feature table marks each of those rows and footnotes them: \"BlueBubbles supports this through its Private API helper, which requires disabling SIP.\" platform-imessage reaches the same rows with SIP on, by operating the real window.\n\n**What the command line does.** `chats`, `chat`, `messages`, `message`, `search` read history with contact-resolved names, tapbacks, stickers, mentions, replies and edit history. `send` and `send-file` send to an address or an existing chat; `create-chat` starts a new direct or group chat with people never messaged before. `reply` and `reply-file` send quoted replies to a message id (or to `latest`, `latest-1`). `react` and `unreact` add or remove a tapback on any message by id, including arbitrary emoji. `edit` and `undo-send` change or retract a sent message inside Apple's time windows. `typing` turns the typing indicator on or off; `mark-read`, `mark-unread`, `mute`, `unmute`, `notify-anyway` and `delete-chat` manage a chat; `activity-status` reports whether the other party is typing and their Do Not Disturb state; `load-attachment` forces an offloaded attachment to download. `start-watching` streams database changes as events. Output is YAML by default and JSON with `--json`.\n\n**How it avoids fighting the person at the keyboard.** By default it launches a secondary instance of the Messages app and drives that window, so the primary window a person is using is left alone. The flag `--no-use-secondary-instance` turns that off.\n\n**Permissions and limits.** Four macOS grants: Accessibility, Contacts (optional, for names), Messages data (Full Disk Access) and Automation for Messages. The README states what it will not do: \"expose more features if you disable SIP, allow automating multiple iMessage accounts, work on Windows/Linux\". Group management (rename, add or remove members, leave, photo) and rich sends (effects, subjects, captions) are listed as planned. Only one process may drive the Messages app at a time. There is no HTTP server, no webhook and no push relay; the README's table gives that row to BlueBubbles.\n\n**Fragility.** Because acting means locating message cells in a live window, a macOS release that rearranges the Messages interface can break an action until the library is updated; the project's todo list tracks such fixes per macOS version. Reading is not affected by that, since it comes from the database.\n\n**Verdict.** On a Mac with SIP on, platform-imessage is the only maintained program that reaches reactions on arbitrary messages, quoted replies, edits, unsends, typing and read state. Its cost is the Accessibility route: slower than a database read, dependent on the window layout, and exclusive of any other automation touching the Messages app at the same moment.\n","register":"standard","hero":"https://miscsubjects.com/img/gen/arcads-gpt-image-36f1b69d-1654-43f9-aa28-1f0c28d9386e.png","hero_brief":"Two identical white desk telephones side by side on a walnut desk; a brass articulated mechanical hand lifts the handset of the second telephone while the first stays untouched; afternoon window light.","editorial_review":{"headline_subject":"Beeper's library that drives a second Messages window through Accessibility","hero_subject":"two identical desk telephones, the second one's handset lifted by a brass mechanical hand","visual_action":"a mechanical hand lifts the second telephone's handset while the first telephone stays untouched","rationale":"the library's defining move is to operate a second, identical instance of the Messages app by machine so the one a person is using is left alone; two identical phones with only the second handled shows exactly that","hero_brief":"Two identical white desk telephones side by side on a walnut desk; a brass articulated mechanical hand lifts the handset of the second telephone while the first stays untouched; afternoon window light.","inspected":true,"inspection_note":"Visible: two identical white push-button desk telephones on a walnut desk; a brass articulated mechanical hand and forearm lifts the handset of the right-hand telephone while the left one is untouched; soft window light from the left. No people, no logos; only the phones' keypad digits are legible. Matches the brief."},"tags":["reference","imessage","mac","messaging","accessibility"],"category":"reference","style":{},"claims":[{"id":"c1","text":"platform-imessage is an open-source Swift library and command-line program from Beeper, the multi-network chat company, that automates the Messages app on a Mac.","section":"platform-imessage: Beeper's Swift library that drives the Messages app through Accessibility","tier":"definition","source_ids":["s1"],"why_material":"identifies the system and what it is"},{"id":"c2","text":"For acting, it does what a person does: it drives the Messages app's own window through macOS Accessibility, plus Apple's automation events for plain sends.","section":"Two mechanisms, one program","tier":"definition","source_ids":["s1"],"why_material":"the mechanism that distinguishes it from every scripting-only tool"},{"id":"c3","text":"The other established route to those features, BlueBubbles, reaches them through a Private API helper that only loads when System Integrity Protection is off; platform-imessage reaches the same rows with SIP on.","section":"Why that matters","tier":"observational","source_ids":["s1"],"why_material":"decides whether a Mac must lower its security posture to get reactions, replies, edits and unsends"},{"id":"c4","text":"Four macOS grants: Accessibility, Contacts (optional, for names), Messages data (Full Disk Access) and Automation for Messages.","section":"Permissions and limits","tier":"regulatory","source_ids":["s1"],"why_material":"what an operator must grant before any action works"}],"sources":[{"id":"s1","url":"https://github.com/beeper/platform-imessage","title":"beeper/platform-imessage README","quote":"A standalone Swift library and CLI that lets you and your agents send/receive messages and fully automate iMessage locally on your Mac."},{"id":"s2","url":"https://github.com/beeper/platform-imessage#features","title":"beeper/platform-imessage README, feature table footnote","quote":"BlueBubbles supports this through its Private API helper, which requires disabling SIP."}],"prov":{"model":"unattributed","action":"write"}}