setup-imessage-node SKILL.md skillA

setup-imessage-node from spshulem/openagi is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add spshulem/openagi/setup-imessage-node@git:20260819.4ca793d

Pins git:20260819.4ca793d in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
spshulem/openagi
Path
examples/skills/setup-imessage-node/SKILL.md
Versions recorded
2
Latest version
git:20260819.4ca793d, committed Aug 19, 2026
First version recorded
Jun 15, 2026
Size
2,392 bytes
Repository stars
19
License
a license file GitHub does not identify

Guide setting up a Mac as an iMessage node — relays incoming texts to the main agent (trigger word) and answers iMessage searches.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

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.

The normal setup is one signed OpenAGI app process, not separate Node services:
- Set `OPENAGI_IMESSAGE_BRIDGE=1`, `IMESSAGE_RESPOND=trigger`, and `IMESSAGE_TRIGGER=<TriggerWord>` on the Messages Mac. Optional `IMESSAGE_ALLOW=<handle,handle>` and `IMESSAGE_ALLOW_CHAT=<chatId>` narrow who can invoke it. Ambient capture stays off unless explicitly enabled.
- Set `OPENAGI_IMESSAGE_SEARCH=1` only when the user wants the paired main to perform bounded read-only searches. Search travels over the authenticated outbound node relay; do not open an inbound iMessage port.

Steps to give the user:
1. Install and launch the signed OpenAGI app on the Mac, then pair it to the HTTPS main with `openagi pair <main>` using the documented hidden token input.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add spshulem/openagi/setup-imessage-node@sha256:5909576a7f11c0bc

The line at the top of this page pins the label git:20260819.4ca793d, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_3ndad6eyab2veubi.svg)](https://markdownregistry.com/a/art_3ndad6eyab2veubi)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, between Jun 15, 2026 and Aug 19, 2026, about one every 64 days.

versioncommittedcommitsizeaudit
git:20260819.4ca793d latest2026-08-19 4ca793d 2,392 BA view · diff
git:20260615.82ecab12026-06-15 82ecab1 2,229 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (2392 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

spshulem/openagi · 19 stars · license a license file GitHub does not identify · pushed 2026-11-07 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_3ndad6eyab2veubi
GET https://markdownregistry.com/api/v1/resolve?ref=spshulem/openagi/setup-imessage-node
GET https://markdownregistry.com/api/v1/blob/5909576a7f11c0bc02855b3320ab6e1c618bdb247b032fac8c75c5fdec7bfc3a

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from spshulem/openagi

openagi-audit-improve SKILL.md skill
spshulem/openagi · .agents/skills/openagi-audit-improve/SKILL.md · Audit a running OpenAGI installation and implement verified generic fixes when the user requests improvements or an…
git:20260917.50bc193 · audit A · 19 stars
openagi-cron-spine-hardening SKILL.md skill
spshulem/openagi · .agents/skills/openagi-cron-spine-hardening/SKILL.md · Use when changing openAGI cron scheduling, ABI runtime ticks, cron job timeout behavior, file-backed cron markers, or…
git:20260805.a4c6544 · audit A · 19 stars
openagi-data-dir-boot SKILL.md skill
spshulem/openagi · .agents/skills/openagi-data-dir-boot/SKILL.md · Use when adding or changing openAGI persistent stores, env-file loading, OPENAGI_DATA_DIR handling, src/data-dir.js…
git:20260805.a4c6544 · audit A · 19 stars
openagi-hosted-event-bridge SKILL.md skill
spshulem/openagi · .agents/skills/openagi-hosted-event-bridge/SKILL.md · Use when changing openAGI hosted-interface event bus wiring, SSE broadcast event names, outreach feed/digest routes…
git:20260805.a4c6544 · audit A · 19 stars
openagi-inbound-trust-boundary SKILL.md skill
spshulem/openagi · .agents/skills/openagi-inbound-trust-boundary/SKILL.md · Use when changing openAGI hosted route auth, isPublicRoute, webhook secret checks, the Telegram pairing allowlist, or…
git:20260805.a4c6544 · audit A · 19 stars
openagi-sqlite-test-isolation SKILL.md skill
spshulem/openagi · .agents/skills/openagi-sqlite-test-isolation/SKILL.md · Prevent and diagnose SQLite database locking failures in openAGI tests and store changes.
git:20260805.a4c6544 · audit A · 19 stars
connect-mcp SKILL.md skill
spshulem/openagi · examples/skills/connect-mcp/SKILL.md · Connect an MCP server (catalog or custom URL/stdio) and make its tools usable — including completing OAuth on a…
git:20260615.82ecab1 · audit B · 19 stars
deploy-update-node SKILL.md skill
spshulem/openagi · examples/skills/deploy-update-node/SKILL.md · Roll out new openAGI code to the main and to Mac nodes (iMessage / computer-use), and restart them safely.
git:20260615.d1d67a3 · audit A · 19 stars
diagnose-agent-tool-errors SKILL.md skill
spshulem/openagi · examples/skills/diagnose-agent-tool-errors/SKILL.md · Troubleshoot opaque model/tool failures and runaway budget — and their usual root causes.
git:20260615.d1d67a3 · audit A · 19 stars
diagnose-no-imessage-replies SKILL.md skill
spshulem/openagi · examples/skills/diagnose-no-imessage-replies/SKILL.md · Troubleshoot why the agent stopped replying to iMessages, in priority order.
git:20260615.d1d67a3 · audit A · 19 stars
drive-computer-use SKILL.md skill
spshulem/openagi · examples/skills/drive-computer-use/SKILL.md · Operate a connected computer-use node to accomplish an on-screen task — screenshot, reason, act in a loop.
git:20260819.fe4a923 · audit A · 19 stars
fleet-supervisor SKILL.md skill
spshulem/openagi · examples/skills/fleet-supervisor/SKILL.md · Keep every Codex, Claude, and Conductor coding thread moving until its PR is truly merge-ready; ping the owner only…
git:20261010.963f3a2 · audit A · 19 stars

Every file in spshulem/openagi

Browse by kind, by grade A, or by owner.