whatsapplisted

# WhatsApp Use this plugin when the user needs WhatsApp conversation context, media inspection, local reply drafts, or an explicitly approved send. Use the installed `whatsapp --json ...` CLI for the actual WhatsApp operations. This plugin is the product shell and operating manual around that CLI and its local bridge. ## Start Check health first when bridge status matters: ```bash whatsapp --json doctor whatsapp --json bridge status ``` Start or relink only when needed: ```bash whatsapp --json bridge start whatsapp bridge relink --confirm ``` Relink uses WhatsApp's QR pairing flow by default. When the QR is shown or written to `~/.local/share/codex-whatsapp/upstream-qr.png`, tell the user to open WhatsApp -> Linked devices -> Link a device, then scan it. If QR pairing fails again, rerun relink with `WHATSAPP_USE_PHONE_PAIRING=1` to use the phone-number code fallback. ## Reading - Discover chats with metadata first; avoid reading message bodies until the target is clear. - Use contact/chat resolution before broad message reads when the user names a person. - Use message context when replies or nearby discussion matter. - Download media only when the media itself is needed for the task. - For a specific WhatsApp audio message, prefer the cached ElevenLabs path: `whatsapp --json media transcribe MESSAGE_ID "CHAT_JID" --language es`. This downloads and transcribes only that requested message, stores the transcript in the local transcript cache, and returns cached