wacli

Send WhatsApp messages and sync chat histories via the wacli CLI.

Updated Feb 27, 2026
One-click install
npx skills add https://github.com/spoonbobo/trinity --skill wacli-spoonbobo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wacli
Source: https://github.com/spoonbobo/trinity/tree/main/app/skills/wacli
Command: npx skills add https://github.com/spoonbobo/trinity --skill wacli-spoonbobo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

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

Core Features & Use Cases

  • Send Messages: Compose and send text messages or files to specific WhatsApp contacts or groups.
  • Sync History: Perform initial syncs or continuous background syncing of WhatsApp conversations.
  • Search History: Query past messages for specific keywords or within date ranges.
  • Use Case: You need to inform a client about a meeting delay. Use this Skill to send a WhatsApp message directly to their number with the updated details.

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 send WhatsApp messages from the command line?

You can send WhatsApp messages from the command line by using the wacli interface to specify a recipient's JID and message content. The skill requires explicit confirmation of the recipient and message before sending text or files to individuals and groups.

Can I sync and search WhatsApp chat history via CLI?

Yes, you can sync WhatsApp chat history via CLI by performing initial syncs or continuous background syncing. Once synced, you can search past messages for specific keywords or filter results within specific date ranges.

How do I send files to WhatsApp groups using a CLI?

To send files to WhatsApp groups using a CLI, you identify the target group chat using its JID and specify the file path. The system requires explicit recipient and file confirmation to ensure safe message delivery.

What is a JID for identifying WhatsApp chats?

A JID is the identifier used to specify WhatsApp chats and groups when sending messages or syncing history. You must provide the correct JID to route your text messages or files accurately through the command-line interface.

Does the WhatsApp CLI require confirmation before sending messages?

Yes, the WhatsApp CLI requires explicit recipient and message confirmation before sending anything. This safety mechanism prevents accidental message delivery when automating communication to individuals or groups.

What are the limitations of automating WhatsApp messaging via CLI?

Automating WhatsApp messaging via CLI requires explicit recipient and message confirmation for each operation, which limits fully autonomous batch sending. Additionally, you must use specific JIDs to identify chats, preventing usage without exact identifiers.