wacli

Send WhatsApp messages and sync or search chat history via wacli CLI.

Updated May 8, 2026
One-click install
npx skills add https://github.com/freire19/Mythos --skill wacli-freire19
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wacli
Source: https://github.com/freire19/Mythos/tree/main/skills/wacli
Command: npx skills add https://github.com/freire19/Mythos --skill wacli-freire19

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents risky, accidental WhatsApp outreach by providing a controlled way to message other people or to search and backfill WhatsApp history when explicitly requested.

Core Features & Use Cases

  • Explicit messaging: Send direct or group WhatsApp messages and share files with required recipient + message confirmation.
  • History search & sync: Authenticate, sync, and search chats/messages by query and time range.
  • Backfill for missing periods: Backfill message history for a specific chat JID with best-effort results when the phone is online.

Quick Start

Use wacli to send a message by asking: "Send a WhatsApp text to +14155551212 saying 'Are you free at 3pm?' (please confirm the recipient and message before sending)."

Frequently Asked Questions about wacli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send a WhatsApp message with explicit recipient confirmation?▼

To send a WhatsApp message safely, you must provide an explicit recipient JID or phone number and the exact message text. The system requests confirmation before transmission to prevent accidental outreach.

Can I search and sync my WhatsApp chat history by a specific date range?▼

Yes, you can sync and search WhatsApp chat history by providing a specific query and time range. The system retrieves historical messages and returns the results in machine-readable JSON output.

What is WhatsApp message backfill and when do I need it?▼

WhatsApp message backfill retrieves missing chat history for a specific JID and date range. It provides best-effort results when the paired phone is online, ensuring continuous message records for third-party outreach tasks.

Does this WhatsApp messaging tool work for both direct messages and group chats?▼

Yes, the tool supports sending direct WhatsApp messages and group messaging. It requires explicit recipient identification and message text for both types of outreach to maintain controlled communication.

How do I retrieve WhatsApp chat history in a machine-readable format?▼

You can retrieve WhatsApp chat history in machine-readable JSON output by using the built-in CLI. This allows you to authenticate, sync, and query messages programmatically for specific JIDs and time periods.