---
name: imessage
description: On-demand, read-only read of the owner's local iMessage/SMS (the macOS Messages history). Use when the owner asks "what did X text me", "any texts I haven't replied to", "catch me up on my thread with …", "read my messages since yesterday", or "did anyone text me about …". The owner asks in plain language — never make them run a command. The agent runs the reader as plumbing and answers with a synthesized read (grouped by person, newest first, flagging what needs a reply), then offers to open any thread in full. Read-only: it never sends, replies, or writes to the vault. Runs on the local machine where Messages is signed in, not an automation host, and needs macOS Full Disk Access. NOT for email/chat triage (that's attention-digest), NOT for sending texts, NOT the daily digest. Requires the imessage module.
---

# imessage — folder-root adapter

The real playbook lives in the brain: **`Agent/skills/imessage.md`** (this folder
is the vault root). Read that file and follow it exactly as written, using the
shipped CLI at `.alexandria/app/.venv/bin/alexandria` wherever it says
`alexandria`, and `.alexandria/app/.venv/bin/python` for
`python -m alexandria_vault.…` entrypoints.

If `Agent/config.json` does not exist, nothing is installed yet — stop and
follow `./CLAUDE.md` (the installer) instead of this skill.
