wacli

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

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

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 search and sync your WhatsApp history directly from the command line, bypassing the need for manual interaction with 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.
  • Sync History: Keep your WhatsApp message history up-to-date.
  • Use Case: You need to quickly send a message to a client whose WhatsApp number you have, or you want to find an old conversation about a specific topic without scrolling through your entire chat history.

Quick Start

Use wacli to send a text message to the phone number +1234567890 with the message "Hello from GenSparx".

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 using a CLI tool that connects to your WhatsApp account. This allows you to send text messages and files to individual contacts or groups without opening the app.

Can I search my WhatsApp chat history for specific keywords via CLI?

Yes, you can search your WhatsApp chat history via CLI to find messages matching specific keywords. This lets you locate old conversations without manually scrolling through your entire chat history in the app.

What do I need to set up before sending WhatsApp messages through a CLI tool?

Before sending WhatsApp messages through a CLI tool, you need the specific binary installed and authenticated for WhatsApp access. This setup ensures your command-line interface has the required permissions to interact with your account.

Does this CLI approach support sending file attachments to WhatsApp groups?

Yes, this CLI approach supports sending file attachments to WhatsApp groups. You can compose and send both text messages and files directly to individual contacts or groups from your terminal.

What is the best way to keep my WhatsApp message history synchronized for searching?

The best way to keep your WhatsApp message history synchronized for searching is to use a CLI tool with history sync capabilities. This ensures your local message history stays up-to-date for accurate querying.

Are there limitations when managing WhatsApp history through a command-line interface?

Managing WhatsApp history through a command-line interface requires the wacli binary to be installed and authenticated. It is limited to direct messaging, group messaging, file attachments, message searching, and history synchronization tasks.