---
name: whatsapp
description: On-demand, read-only read of the owner's local WhatsApp history (the native macOS WhatsApp app's store). Use when the owner asks "what did X send me on WhatsApp", "any WhatsApp messages I haven't replied to", "catch me up on the <group> chat", "read my WhatsApp since yesterday", or "did anyone WhatsApp 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 chat, newest first, flagging what needs a reply), then offers to open any chat in full. Read-only: it never sends, replies, or writes to the vault. Runs on the local machine where the WhatsApp Mac app is signed in, not an automation host, and needs macOS Full Disk Access. NOT iMessage/SMS (that's the imessage skill), NOT email/chat triage (attention-digest), NOT for sending messages. Requires the whatsapp module.
---

# whatsapp — folder-root adapter

The real playbook lives in the brain: **`Agent/skills/whatsapp.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.
