# wacli | Peter Steinberger | Knowledge Base | Instagit

WhatsApp CLI

GitHub Stars: 1.8k

Repository: https://github.com/steipete/wacli

---

## Articles

### [How to Send Files with Custom Display Filenames in wacli](/steipete/wacli/how-wacli-sends-files-with-custom-display-filenames)

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.

- Tags: how-to-guide
- Published: 2026-04-17

### [How the wacli doctor Command Diagnoses Connection and Authentication Issues](/steipete/wacli/how-wacli-doctor-command-diagnoses-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.

- Tags: how-to-guide
- Published: 2026-04-17

### [Understanding the wacli Bootstrap Sync Process After Authentication](/steipete/wacli/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.

- Tags: deep-dive
- Published: 2026-04-17

### [How to Use Invite Links Programmatically with wacli to Join WhatsApp Groups](/steipete/wacli/how-to-programmatically-use-invite-links-with-wacli)

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

- Tags: how-to-guide
- Published: 2026-04-17

### [Recommended Security Permissions for the wacli Store Directory: A Complete Guide](/steipete/wacli/recommended-security-permissions-wacli-store-directory)

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

- Tags: best-practices
- Published: 2026-04-17

### [How to Run wacli as a Non-Interactive Daemon or in Scripts](/steipete/wacli/how-to-run-wacli-daemon-scripted-mode)

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.

- Tags: how-to-guide
- Published: 2026-04-17

### [How the JSON Output from wacli Commands Is Structured](/steipete/wacli/how-wacli-json-output-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.

- Tags: api-reference
- Published: 2026-04-17

### [What Happens When FTS5 Is Not Available and wacli Falls Back to LIKE Queries](/steipete/wacli/what-happens-when-fts5-unavailable-like-fallback)

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

- Tags: internals
- Published: 2026-04-17

### [Exponential Backoff for Reconnections in wacli: Implementation and Usage](/steipete/wacli/explain-wacli-exponential-backoff-reconnection-logic)

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

- Tags: internals
- Published: 2026-04-17

### [How WACLI_DEVICE_LABEL and WACLI_DEVICE_PLATFORM Control WhatsApp Client Identity in wacli](/steipete/wacli/wacli-environment-variables-device-label-platform)

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

- Tags: internals
- Published: 2026-04-17

### [How wacli's Message Upsert Logic Prevents Duplicate Entries During History Sync Replays](/steipete/wacli/wacli-message-upsert-prevent-duplicates-history-sync)

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.

- Tags: internals
- Published: 2026-04-17

### [What Causes Device Replaced Errors in wacli and How Store Locking Prevents Them](/steipete/wacli/wacli-device-replaced-errors-and-locking)

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

- Tags: internals
- Published: 2026-04-17

### [How wacli Handles WhatsApp Group Management: Participants, Invites, and Renaming](/steipete/wacli/wacli-group-management-participants-invites-renaming)

Discover how wacli simplifies WhatsApp group management. Learn about handling participants, invite links, and renaming, all backed by WhatsMeow and local persistence.

- Tags: how-to-guide
- Published: 2026-04-17

### [How the Local Contact Alias and Tagging System Works in wacli](/steipete/wacli/how-local-contact-alias-tagging-system-works)

Discover how wacli's local contact alias and tagging system uses SQLite tables for nicknames and labels. Learn about CRUD operations and CLI commands to manage your contacts efficiently.

- Tags: internals
- Published: 2026-04-17

### [Database Structure for Storing Messages, Chats, and Contacts in WACLI](/steipete/wacli/wacli-database-schema-for-messages-chats-contacts)

Explore the WACLI database structure using SQLite with chats contacts and messages tables. Understand how WhatsApp data is stored locally in this technical deep dive.

- Tags: internals
- Published: 2026-04-17

### [Authentication Process Using QR Codes in wacli: How It Works and Why It Differs from Sync](/steipete/wacli/wacli-qr-code-authentication-vs-sync)

Learn how wacli QR code authentication creates new WhatsApp Web sessions and how it differs from the sync command. Understand the wacli auth process.

- Tags: internals
- Published: 2026-04-17

### [How wacli Downloads and Stores Media Files Locally: A Complete Technical Guide](/steipete/wacli/how-media-files-are-downloaded-and-stored-locally)

Discover how wacli downloads and stores media files locally. This technical guide details the four-stage pipeline: SQLite metadata, path resolution, streaming, and atomic file movement.

- Tags: deep-dive
- Published: 2026-04-17

### [How wacli Uses SQLite FTS5 for Full-Text Search: Implementation and Fallback Strategy](/steipete/wacli/how-fts5-is-used-for-full-text-search)

Discover how wacli leverages SQLite FTS5 for efficient full-text search, with a fallback to LIKE queries and real-time indexing using triggers.

- Tags: internals
- Published: 2026-04-17