wacli

WhatsApp CLI

18 articles 1.8k View on GitHub ↗
18 articles
How to Send Files with Custom Display Filenames in wacli

Learn how to send files with custom display filenames using the wacli send file --filename flag. wacli handles actual file paths for MIME detection and hashing.

how-to-guide
Apr 17, 2026
How the wacli doctor Command Diagnoses Connection and Authentication Issues

Troubleshoot wacli connection and authentication problems with the doctor command. This diagnostic tool checks your local store, authentication, and network status to resolve errors.

how-to-guide
Apr 17, 2026
Understanding the wacli Bootstrap Sync Process After Authentication

Explore the wacli bootstrap sync process after authentication. Learn how it imports contacts, syncs history, stores messages, and self-exits.

deep-dive
Apr 17, 2026
How to Use Invite Links Programmatically with wacli to Join WhatsApp Groups

Learn to programmatically join WhatsApp groups using wacli invite links. Execute commands or call Go functions to automate group joining efficiently.

how-to-guide
Apr 17, 2026
Recommended Security Permissions for the wacli Store Directory: A Complete Guide

Learn the recommended security permissions for the wacli store directory. Secure your WhatsApp session keys and chat data with POSIX mode 0700.

best-practices
Apr 17, 2026
How to Run wacli as a Non-Interactive Daemon or in Scripts

Learn how to run wacli as a non-interactive daemon or in scripts. Authenticate once then use sync flags for automation with machine-readable JSON output.

how-to-guide
Apr 17, 2026
How the JSON Output from wacli Commands Is Structured

Understand the wacli JSON output structure. Learn how success status data and errors are presented in a standardized envelope for clear command results.

api-reference
Apr 17, 2026
What Happens When FTS5 Is Not Available and wacli Falls Back to LIKE Queries

Discover what happens when FTS5 is unavailable in wacli. Learn how it gracefully falls back to LIKE queries and remains fully functional.

internals
Apr 17, 2026
Exponential Backoff for Reconnections in wacli: Implementation and Usage

Discover wacli's exponential backoff for reconnections. Learn how it increases delays between attempts, respects bounds, and handles context cancellation for robust connectivity.

internals
Apr 17, 2026
How WACLI_DEVICE_LABEL and WACLI_DEVICE_PLATFORM Control WhatsApp Client Identity in wacli

Learn how WACLI_DEVICE_LABEL and WACLI_DEVICE_PLATFORM control your WhatsApp client identity in wacli. Understand device name and platform settings for compatibility.

internals
Apr 17, 2026
How wacli's Message Upsert Logic Prevents Duplicate Entries During History Sync Replays

Discover how wacli's message upsert logic prevents duplicate entries during history sync replays using SQLite's ON CONFLICT clause and a unique composite constraint. Learn to avoid data duplication.

internals
Apr 17, 2026
What Causes Device Replaced Errors in wacli and How Store Locking Prevents Them

Learn what causes device replaced errors in wacli and how store locking prevents multiple instances from corrupting your WhatsApp device identity. Ensure seamless operation.

internals
Apr 17, 2026

Have a question about this repo?

These articles cover the highlights, but your codebase questions are specific. Give your agent direct access to the source. Share this with your agent to get started:

Share the following with your agent to get started:
curl -s "https://instagit.com/install.md"

Works with
Claude Codex Cursor VS Code OpenClaw Any MCP Client

Maintain an open-source project? Get it listed too →