wacli

Send WhatsApp messages and manage chat history via the wacli command-line interface.

Updated Mar 2, 2026
One-click install
npx skills add https://github.com/chebizarro/swarmstr --skill wacli-chebizarro
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wacli
Source: https://github.com/chebizarro/swarmstr/tree/main/skills/wacli
Command: npx skills add https://github.com/chebizarro/swarmstr --skill wacli-chebizarro

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill allows for programmatic sending of WhatsApp messages to external contacts and for searching or syncing WhatsApp chat history, 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: Find specific messages within chats based on keywords and date ranges.
  • Sync History: Backfill past messages from chats for historical record-keeping.
  • Use Case: A business needs to send an urgent update to a client via WhatsApp or retrieve past conversation details for a support ticket.

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?

To send WhatsApp messages via the command line, use the wacli interface to target specific chat JIDs. It supports sending text and files to both individual contacts and groups programmatically without manual app interaction.

Can I search WhatsApp chat history by keyword and date?

Yes, you can search WhatsApp chat history by specific keywords and date ranges. This functionality allows you to find past messages within targeted chats for support ticket resolution or historical record-keeping.

How do I backfill past messages from a WhatsApp chat?

You can backfill past messages from a WhatsApp chat using the history sync feature. This retrieves and syncs historical conversation data programmatically via the command line for historical record-keeping.

Do I need to authenticate with a QR code to use a WhatsApp CLI?

Yes, authenticating via a QR code is required to use this WhatsApp CLI. This authentication step grants the command-line interface access to your account for sending messages and syncing chat history.

What are the limitations of sending WhatsApp messages via a CLI tool?

The primary limitation of CLI tools for WhatsApp messaging is the requirement to authenticate via QR code and target conversations using chat JIDs. They handle direct and group messaging but do not replace manual app interaction.