wacli

Send WhatsApp text and file messages and search chat history via wacli.

455|34|Updated Mar 9, 2026
One-click install
npx skills add https://github.com/understudy-ai/understudy --skill wacli-understudy-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wacli
Source: https://github.com/understudy-ai/understudy/tree/main/skills/wacli
Command: npx skills add https://github.com/understudy-ai/understudy --skill wacli-understudy-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill allows for programmatic interaction with WhatsApp, enabling users to send messages to contacts or groups and manage their chat history without manual intervention in the WhatsApp application.

Core Features & Use Cases

  • Send Messages: Compose and send text or file messages to individual contacts or WhatsApp groups.
  • Sync History: Initiate and maintain synchronization of WhatsApp message history.
  • Search History: Query past messages for specific keywords or within date ranges.
  • Use Case: Automatically send a status update message to a project group chat or search your entire WhatsApp history for a specific document shared last year.

Quick Start

Use the wacli skill to send a text message to +14155551212 with the message Hello! Are you free at 3pm?

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 programmatically without manual app interaction?

Send WhatsApp messages programmatically via the wacli command-line interface, which supports sending text and files to individual contacts or groups without manual app interaction.

Can I search my WhatsApp chat history for specific keywords and date ranges?

Search WhatsApp chat history by querying past messages for specific keywords or within defined date ranges to find shared documents or past conversations.

What do I need to set up before using a CLI tool for WhatsApp automation?

Install the wacli binary and complete WhatsApp authentication to enable programmatic message sending and chat history synchronization via the command-line interface.

How do I backfill and sync WhatsApp message history automatically?

Initiate and maintain WhatsApp message history synchronization using the wacli command-line interface to backfill past chat records and keep message history current.

Can I send files to WhatsApp groups using command-line automation?

Send files to WhatsApp groups programmatically using the wacli command-line interface, which supports sending both text and file messages to individual contacts and groups.