wacli

wacli connects to WhatsApp using a QR-code login flow and syncs your message store locally to ~/.wacli. Once authenticated, the agent can query that local store or dispatch messages through WhatsApp's servers. The skill follows a careful safety protocol:The agent requires an explicit recipient and message before doing anything.It confirms both the recipient and message content with you before sending.If anything is ambiguous, it pauses and asks a clarifying question.Use --json flag for machine-readable output when the agent needs to parse results programmatically.

Send Text Messages — Dispatch text messages to any WhatsApp contact (+14155551212) or group (@g.us JID) with a simple command.Send Files — Attach and send files such as PDFs with an optional caption to any contact or group.Search Message History — Full-text search across your synced messages with date-range filters (--after, --before) and per-chat scoping.Chat Listing — List and query your recent chats by name or number to resolve JIDs before sending.History Backfill — Request older messages from WhatsApp's servers (requires your phone to be online).Continuous Sync — Keep your local message store up to date in the background with wacli sync --follow.Safety-First Design — Built-in confirmation step before every send action; ambiguous inputs trigger a clarifying question rather than guessing.

WhatsApp Account — Required. You must authenticate via QR code login using wacli auth before any send or sync operations. Your phone must remain associated with the account.Phone Online for Backfill — Optional, but your phone must be online and accessible when using wacli history backfill; results are best-effort.

Agent-Driven Outreach — Ask your agent to notify a contractor, teammate, or client on WhatsApp without leaving your workflow.File Delivery — Have the agent send a PDF, invoice, or document to a contact with a custom caption.Conversation Research — Search months of WhatsApp history for a specific topic, keyword, or date range to surface past agreements or details.Group Notifications — Send a quick update to a WhatsApp group, such as a project team or family group, from an automated workflow.