wacli

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

Updated Feb 16, 2026
One-click install
npx skills add https://github.com/travis-burmaster/agentbox --skill wacli-travis-burmaster
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wacli
Source: https://github.com/travis-burmaster/agentbox/tree/main/agentfork/skills/wacli
Command: npx skills add https://github.com/travis-burmaster/agentbox --skill wacli-travis-burmaster

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It lets an AI agent message third parties on WhatsApp and search or backfill WhatsApp chat history from the command line, without touching the WhatsApp app manually. ## Core Features & Use Cases - Send Messages: Send text or file messages to individual contacts or groups using phone numbers or JIDs. - Search & Sync History: Authenticate via QR login, sync chats continuously, and search messages by keyword, chat, or date range. - History Backfill: Request older messages for a specific chat when recent sync data is insufficient. - Use Case: A user asks the agent to message a contractor at +14155551212 confirming a 3pm meeting; the agent confirms the recipient and text, then runs wacli send text to deliver it. ## Quick Start Ask the agent to send a WhatsApp message to a specific phone number with your exact message text, and confirm the recipient before it sends.

Frequently Asked Questions about wacli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send a WhatsApp message from the command line?

Use wacli send text with the recipient's phone number and message, for example wacli send text --to "+14155551212" --message "Hello". For groups, use the group JID ending in @g.us, and for attachments use wacli send file with a file path and optional caption.

How do I search WhatsApp chat history with wacli?

Run wacli messages search with your query, optionally filtering by chat JID or date range with --after and --before. Use wacli chats list first to find the correct chat JID, and add --json for machine-readable output.

When should I use wacli instead of normal WhatsApp chat routing?

Use wacli only when explicitly asked to message a third party or to search and sync WhatsApp history. Routine conversations with the user on WhatsApp are routed automatically and should not go through this tool.

Does wacli history backfill work offline?

No, history backfill requires your phone to be online because it requests older messages through the linked device. Results are best-effort, so some older messages may not be retrieved.

How do I authenticate wacli with my WhatsApp account?

Run wacli auth to complete QR-code login and initial sync, then use wacli sync --follow for continuous syncing. The wacli doctor command checks the setup, and data is stored in ~/.wacli unless overridden with --store.