wazzup-cli

Send WhatsApp messages from the terminal.

Install

npm install -g wazzup-cli

Quick Start

1. Log in

wazzup login

Scan the QR code with WhatsApp on your phone (Linked Devices → Link a Device).

2. Send a message

wazzup send --to "+491234567890" --message "Hello from the terminal!"

3. Pipe messages via stdin

echo "Server is down!" | wazzup send --to "+491234567890"

4. Listen for incoming messages

wazzup receive

Commands

wazzup login

Connect to WhatsApp by scanning a QR code. Session is saved locally so you only need to do this once.

wazzup logout

Delete stored session credentials.

wazzup send

Send a message to a phone number.

Option	Description
--to <number>	Recipient phone number with country code (e.g. +491234567890)
--message <text>	Message text. If omitted, reads from stdin.

wazzup receive

Listen for incoming messages and print them to stdout. Runs until Ctrl+C.

Option	Description
--from <number>	Only show messages from this number
--json	Output one JSON object per line (for scripting)

Human-readable output (default):

[2026-02-11 16:30] +491234567890 (Jens): Hello there
[2026-02-11 16:31] +491234567890 (Jens): How are you?

JSON output (--json):

{"timestamp":"2026-02-11T15:30:00.000Z","from":"+491234567890","name":"Jens","message":"Hello there"}

Examples:

# All messages as JSON, pipe to jq
wazzup receive --json | jq '.message'

# Only messages from one contact
wazzup receive --from "+491234567890"

wazzup config

View or update configuration.

Option	Description
--default-number <number>	Set a default recipient so you can skip --to

# Set a default number
wazzup config --default-number "+491234567890"

# Then just
wazzup send --message "Quick message"

How It Works

wazzup-cli uses Baileys, an open-source WhatsApp Web API library. It connects as a linked device to your WhatsApp account — no separate phone number or WhatsApp Business account needed.

Session credentials are stored in ~/.whatsapp-cli/auth/.

License

MIT