Skip to content

CLI commands

PyWacli is a Typer app. Run any command directly, or run pywacli with no arguments for the interactive menu.

Command summary

Command Description
pywacli Open the interactive menu
pywacli dashboard Launch the live Rich dashboard
pywacli connect Connect WhatsApp (shows QR), stream and save events
pywacli send Send a WhatsApp message
pywacli automate Start the AI-powered auto-reply bot
pywacli media Browse and download stored media
pywacli config Open the configuration menu
pywacli setup Run the interactive configuration wizard
pywacli init Install the Node.js (Baileys) dependencies

Global options on the root command:

Option Short Description
--setup -s Run the configuration wizard
--config -c Open the configuration menu

dashboard

pywacli dashboard

Launches the live terminal dashboard. See the Dashboard guide.

connect

pywacli connect

Starts the Baileys bridge, prints the login QR, and owns the single live WhatsApp socket — saving events and hosting the local command server. Keep the terminal open. See Connect.

send

pywacli send --phone 919876543210 --message "Hello!"
Option Description
--phone Recipient number, country code first, digits only (prompted if omitted)
--message Message text (prompted if omitted)

Sends through a running connect session. See Send.

automate

pywacli automate

Interactive AI auto-reply bot — pick a contact, skill, and provider. See Automate and AI skills & providers.

media

pywacli media

Browse stored media by type and download files. See Media.

config / setup

pywacli setup    # first-time wizard
pywacli config   # edit later

Both open the configuration flow that writes ~/.pywacli/config.json. See Configuration.

init

pywacli init

Verifies node and npm are on your PATH and runs npm install for the bundled Baileys dependencies. Run this once after installing PyWacli from PyPI.