wacli

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

Updated Feb 16, 2026
One-click install
npx skills add https://github.com/RobbyMo81/assistantrobby --skill wacli-robbymo81
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wacli
Source: https://github.com/RobbyMo81/assistantrobby/tree/main/skills/wacli
Command: npx skills add https://github.com/RobbyMo81/assistantrobby --skill wacli-robbymo81

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a safe, auditable way to send messages to third parties and to search or sync WhatsApp chat history from the command line, removing manual phone interactions for non-routine messaging and archival queries.

Core Features & Use Cases

  • Auth & Sync: QR-based login and continuous sync to keep local history current for searches and backfills.
  • Search & Backfill: Query messages and backfill history for a specific chat or date range to retrieve past content.
  • Send Messages & Files: Send text, group messages, and files to explicit JIDs; confirm recipient and content before sending as a safety guard.
  • Machine-friendly Output: JSON output mode for deterministic parsing and automation in scripts and pipelines.

Quick Start

Send a WhatsApp text to +14155551212 with the message "Hello! Are you free at 3pm?" using the wacli send text command and confirm the recipient 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 WhatsApp messages from the command line?

To send WhatsApp messages from the command line, use the wacli send text command with an explicit recipient JID. The system requires recipient and content confirmation before sending to ensure safe, auditable messaging.

Can I search and backfill WhatsApp chat history via CLI?

Yes, you can search and backfill WhatsApp chat history via CLI by querying messages for a specific chat or date range. Continuous sync keeps local history current for retrieving past content without manual phone interactions.

How does CLI WhatsApp authentication work?

CLI WhatsApp authentication works through QR-based login. You scan a QR code to authenticate the wacli binary, which then enables secure access to messaging, sync, and search functionalities.

Does the WhatsApp CLI tool support JSON output for automation?

Yes, the WhatsApp CLI tool supports JSON output for deterministic parsing. This machine-friendly mode enables seamless integration of message searches and archival queries into scripts and automation pipelines.

What is the best way to automate group notifications on WhatsApp?

The best way to automate group notifications on WhatsApp is using the wacli binary to send text and files to explicit JIDs. It provides an auditable, safe method for non-routine messaging without manual phone interactions.

Is this WhatsApp CLI tool suited for routine user chats?

No, this WhatsApp CLI tool is not suited for routine user chats. It is designed for power users and administrators to handle non-routine messaging, group notifications, archival searches, and history backfills.