add-imessage
Add iMessage to NanoClaw — one channel, two backends. Local (this Mac's chat.db via the Chat SDK bridge; macOS + Full Disk Access) or Hosted iMessage (via photon.codes — native spectrum-ts with a device-login wizard; any OS, no Mac relay). Triggers on "add imessage", "connect imessage", "add photon", "imessage via photon", "native imessage".
Profile →npx skills add nanocoai/nanoclaw --skill add-imessage --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Add iMessage NanoClaw talks to iMessage through a single **`imessage`** channel with two pluggable backends: - **Local (this Mac)** — the Chat SDK bridge over `chat-adapter-imessage`, reading this Mac's signed-in iMessage account (`chat.db`). macOS only; the Node binary needs Full Disk Access. - **Hosted iMessage (via photon.codes)** — a native adapter over Photon's `spectrum-ts` gRPC stream. The hosted service owns the iMessage line, so there's no Mac relay, webhook, or public URL. Works on any OS, and a device-login flow provisions everything for you. Both register the same `imessage` channel type; only one runs per install. NanoClaw doesn't ship channels in trunk — this skill copies the unified `imessage` adapter in from the `channels` branch. Full reference: [docs/imessage.md](docs.md). The mechanical steps under **Apply** carry `nc:` directive fences: an agent reads the prose and applies them, and a parser can apply them deterministically from the same document. Every directive is idempotent, so the whole skill is safe to re-run; anything a parser can't apply falls back to the prose beside it. ## Apply ### 1. Choose a backend Pick the backend first — it decides which package
- Apply
- 1. Choose a backend
- 2. Copy the adapter
- 3. Register the adapter
- 4. Install the chosen backend's package
- 5. Build and validate
- Local backend: Full Disk Access (macOS)
- Hosted backend: device login (via photon.codes)
- Restart
- Resolve your iMessage handle
- Next Steps
- Channel Info
- Hosted features
- Troubleshooting
What does the add-imessage skill do?
Add iMessage to NanoClaw — one channel, two backends. Local (this Mac's chat.db via the Chat SDK bridge; macOS + Full Disk Access) or Hosted iMessage (via photon.codes — native spectrum-ts with a device-login wizard; any OS, no Mac relay). Triggers on "add imessage", "connect imessage", "add photon", "imessage via photon", "native imessage".
How do I install it?
Run `npx skills add nanocoai/nanoclaw --skill add-imessage --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From nanocoai/nanoclaw, a repository with 30,426 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.