wacli

Send WhatsApp messages and search chat history via the wacli CLI.

3|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/ybsa/sovereign-kernel --skill wacli-ybsa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wacli
Source: https://github.com/ybsa/sovereign-kernel/tree/main/crates/sk-tools/skills/wacli
Command: npx skills add https://github.com/ybsa/sovereign-kernel --skill wacli-ybsa

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates sending WhatsApp messages to external contacts and allows for searching and syncing WhatsApp message history, streamlining communication beyond direct user chats.

Core Features & Use Cases

  • Send Messages: Programmatically send text or file messages to specific WhatsApp numbers or groups.
  • Sync History: Continuously sync incoming messages or backfill historical data.
  • Search Messages: Find specific messages within chats based on keywords and date ranges.
  • Use Case: Automatically send a meeting reminder to a client's WhatsApp number or search your past conversations for a specific document shared weeks ago.

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 automate sending WhatsApp messages to a phone number?

You can automate sending WhatsApp messages by using a command-line interface to programmatically dispatch text or file attachments directly to specific phone numbers or group JIDs. This requires installing the wacli binary via package managers like Homebrew or Go before executing the send commands.

Can I search my WhatsApp message history by date range?

Yes, you can search WhatsApp message history by filtering specific keywords within chats using defined date ranges. The command-line interface queries your synced historical data to locate and retrieve past conversations or shared documents matching your criteria.

Do I need to install any dependencies to sync WhatsApp chat history?

Yes, you must install the wacli binary through a package manager like Homebrew or Go to sync WhatsApp chat history. This command-line tool manages continuous incoming message syncing and allows you to backfill historical data once installed.

What is the best way to backfill historical WhatsApp messages?

The best way to backfill historical WhatsApp messages is using a command-line interface that supports continuous syncing of incoming data. The wacli tool programmatically retrieves and manages past chat history without requiring manual export from a mobile device.

Can I send file attachments to WhatsApp groups using a CLI?

Yes, you can send file attachments to WhatsApp groups by targeting group JIDs through the command-line interface. This allows you to programmatically share documents and media files directly to group chats alongside standard text messages.

Why use a command-line tool for WhatsApp messaging instead of manual entry?

Using a command-line tool for WhatsApp messaging automates repetitive communication tasks like sending meeting reminders to clients. It enables programmatic dispatch to phone numbers, continuous history syncing, and keyword-based message searching beyond direct user chats.