wacli

Send messages and files to WhatsApp contacts or groups via wacli CLI.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates sending WhatsApp messages to contacts and managing chat history, streamlining communication outside of direct user interactions.

Core Features & Use Cases

  • Send Messages: Send text or files to individual contacts or groups.
  • Search History: Find specific messages within chats.
  • Sync History: Keep chat history up-to-date.
  • Use Case: You need to send a meeting agenda PDF to a client via WhatsApp.

Quick Start

Use wacli to send the file '/path/agenda.pdf' to '+14155551212' with the caption 'Agenda'.

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 and files to contacts from the command line?

You can send WhatsApp messages and files to contacts or groups from the command line by using the wacli CLI. This Skill automates sending text or files directly to specified phone numbers or group chats.

Can I search and sync WhatsApp chat history using a CLI?

Yes, you can search and sync WhatsApp chat history using the wacli CLI. The Skill supports finding specific messages within chats and running history backfill operations to keep your records up-to-date.

Do I need an authenticated WhatsApp account to send messages with wacli?

Yes, sending messages with wacli requires an authenticated WhatsApp account. The Skill supports authenticated QR login to establish the connection needed for managing your WhatsApp communication.

What is the best way to automate sending a PDF to a client via WhatsApp?

The best way to automate sending a PDF to a client via WhatsApp is using this Skill to pass the file path, recipient number, and caption directly to the wacli CLI, streamlining communication outside of direct user interactions.

Does wacli support sending files to WhatsApp groups or only individual contacts?

wacli supports sending files to both individual contacts and WhatsApp groups. You can specify the target recipient within the CLI command to deliver text or files to either destination.

What are the limitations of syncing WhatsApp chat history through a CLI?

Syncing WhatsApp chat history through a CLI requires the wacli tool and an active authenticated WhatsApp account. It is designed for history backfill and searching specific messages rather than serving as a standalone messaging client.