wacli

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill allows you to send WhatsApp messages to external contacts or search your WhatsApp history programmatically, bypassing the need for manual interaction within the WhatsApp application for these specific tasks.

Core Features & Use Cases

  • Send Messages: Compose and send text messages or files to individual contacts or groups.
  • Search History: Query your WhatsApp chat history for specific messages or keywords within a date range.
  • Sync History: Keep your WhatsApp message history synchronized for offline access or analysis.
  • Use Case: Automatically send a meeting reminder to a client's WhatsApp number or search for a specific invoice mentioned in a past conversation.

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 specifying a recipient's JID and composing your text or file payload. The system requires explicit user confirmation before dispatching the message to ensure secure delivery.

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

Yes, you can search your WhatsApp chat history by querying the message archives using specific keywords and defined date ranges. This allows you to quickly locate past conversations or find specific invoices and details without manual scrolling.

Does this CLI tool support sending files to WhatsApp groups?

Yes, the CLI tool supports sending both text messages and files to WhatsApp groups. It handles specific JID formats required for group chats, ensuring your files are correctly routed to the intended group recipients.

What is a WhatsApp history backfill and when do I need it?

A WhatsApp history backfill synchronizes your past message archives for offline access or analysis. You need it when you want to programmatically sync and retrieve historical chat data without manually interacting with the WhatsApp application.

Do I need to confirm before sending messages via the WhatsApp CLI?

Yes, explicit user confirmation is required before sending any WhatsApp messages via the CLI. This safeguard prevents accidental automated dispatches to external contacts or groups, ensuring you maintain control over outbound communication.