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.