wacli

Send WhatsApp messages and search chat history via command-line interface.

2|1|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/simplefarmer69/ape-claw --skill wacli-simplefarmer69
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wacli
Source: https://github.com/simplefarmer69/ape-claw/tree/main/data/forge-skills/wacli
Command: npx skills add https://github.com/simplefarmer69/ape-claw --skill wacli-simplefarmer69

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill allows you to send WhatsApp messages to external contacts or sync/search your WhatsApp history directly from the command line, bypassing the need for manual app interaction for these specific tasks.

Core Features & Use Cases

  • Send Messages: Compose and send text messages or files to individual contacts or groups.
  • Sync History: Perform an initial sync or continuous synchronization of your WhatsApp chat history.
  • Search Messages: Find specific messages within chats based on keywords and date ranges.
  • Use Case: You need to send an urgent update to a client via WhatsApp from a script running on a server.

Quick Start

Use wacli 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 from the command line?

You can send WhatsApp messages from the command line by installing the required wacli binary via Homebrew or Go modules. This allows you to compose and send text messages or files directly to individual contacts and groups.

Can I sync my WhatsApp chat history using a CLI tool?

Yes, you can sync your WhatsApp chat history using a CLI tool. The wacli binary supports performing an initial sync or continuous synchronization of your historical chat data directly from the command line.

How do I search WhatsApp messages by keyword and date range?

To search WhatsApp messages by keyword and date range, use the command-line interface provided by the wacli binary. This feature enables you to find specific messages within your synced chats based on exact keywords and timeframes.

Do I need to install any dependencies to automate WhatsApp messaging?

Yes, you need to install the wacli binary to automate WhatsApp messaging. This prerequisite dependency is installed via Homebrew or Go modules, enabling your command-line scripts to transmit text and files.

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

Yes, you can send files to WhatsApp groups using command line automation. The wacli tool supports file transmissions alongside standard text messages to both individual contacts and groups.

What is the best way to automate urgent WhatsApp updates from a server script?

The best way to automate urgent WhatsApp updates from a server script is using the wacli command-line tool. It bypasses manual app interaction, allowing scripts to send messages and files to contacts automatically.