wacli

Automate WhatsApp messaging workflows via the wacli CLI.

386k|81.1k|Updated Nov 24, 2025
One-click install
npx skills add https://github.com/steipete/clawdis --skill wacli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wacli
Source: https://github.com/steipete/clawdis/tree/main/skills/wacli
Command: npx skills add https://github.com/steipete/clawdis --skill wacli

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires wacli.

What problem does it solve?

This Skill eliminates the need to manually search through WhatsApp conversations and send repetitive messages, freeing up your time for more important work.

Core Features & Use Cases

  • Message Search: Quickly find specific conversations and messages across your WhatsApp history.
  • Automated Messaging: Send texts and files to contacts without touching your phone.
  • Use Case: When you need to send the same important announcement to multiple contacts or search for that one crucial message from months ago.

Quick Start

Search for messages containing the keyword "invoice" from the last 30 days.

Frequently Asked Questions about wacli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search WhatsApp message history from the command line?

Search WhatsApp messages using wacli's search command to find specific conversations and keywords across your chat history. The Skill queries synced messages stored locally, enabling fast retrieval without manual scrolling through your phone.

Can I automate sending WhatsApp messages to multiple contacts?

Yes. Automate WhatsApp messaging by using wacli's send command to deliver texts or files to multiple contacts without touching your phone. The Skill operates only when your paired phone is online, enforcing QR authentication for security.

What does wacli require to sync WhatsApp chats?

Wacli requires QR login authentication with WhatsApp Web and continuous sync to pull chat data into local storage at ~/.wacli. Your phone must remain online for sync and send operations to function.

How far back can I search in my WhatsApp message history?

Wacli supports history backfill to retrieve older messages beyond your initial sync window. The Skill stores all synced data locally, allowing you to search across extended message history depending on your backfill scope.

What if WhatsApp Web connection fails during messaging or sync?

Wacli includes a doctor command to diagnose connection issues and verify pairing status. The Skill enforces that your paired phone stays online; if the connection drops, messaging and sync operations will not proceed until the connection is restored.