Menu
Guide setting up a Mac as an iMessage node — relays incoming texts to the main agent (trigger word) and answers iMessage searches.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | setup-imessage-node |
| description | Guide setting up a Mac as an iMessage node — relays incoming texts to the main agent (trigger word) and answers iMessage searches. |
Walk the user through turning a Mac (signed into iMessage) into an iMessage node. macOS-only, and it needs system permissions you can't grant for them — so produce clear, copy-pasteable steps and explain each grant. Substitute <host>, <port>, <secret>, <TriggerWord> for their values; never hardcode real numbers/tokens.
Two processes (run from the openAGI repo on that Mac):
openagi imessage-bridge --respond trigger --trigger <TriggerWord> --allow <handle,handle> --allow-chat <chatId> --capture all
Reads ~/Library/Messages/chat.db read-only, relays messages containing the trigger to the main, and replies via Messages. Omit --allow* to respond to everyone; --allow-chat opts a group thread in.openagi imessage-server --token <secret> --port <port> (optional)
Serves iMessage SEARCH to the main, giving it a search_imessages tool.Steps to give the user:
node binary; Terminal while testing) Full Disk Access (read chat.db) and Automation → Messages (send replies).RunAtLoad + KeepAlive) that runs the command; restart it with launchctl kickstart -k gui/$(id -u)/<label>.OPENAGI_IMESSAGE_NODE=http://<host>:<port> and OPENAGI_IMESSAGE_NODE_TOKEN=<secret>, then restart.Gotchas to mention:
attributedBody (the text column is NULL); the bridge decodes that typedstream blob.node must be approved separately.User asked: {{input}}
Guide configuring proactive outreach so the main reaches out (digest + live decisions) and the Mac app surfaces it with notifications, an overlay list, and inline buttons.
Roll out new openAGI code to the main and to Mac nodes (iMessage / computer-use), and restart them safely.
Troubleshoot opaque model/tool failures and runaway budget — and their usual root causes.
Troubleshoot why the agent stopped replying to iMessages, in priority order.
Connect an MCP server (catalog or custom URL/stdio) and make its tools usable — including completing OAuth on a headless host.
Operate a connected computer-use node to accomplish an on-screen task — screenshot, reason, act in a loop.