Developer CLI (@wa-ma/cli)

Manage instances, link WhatsApp via QR in the terminal, and send messages without writing HTTP code.

Installation

Run once with npx or install globally:

curl

npx @wa-ma/cli --help
# or
npm install -g @wa-ma/cli

First-time setup

1. Register at the dashboard and copy your user ID and user API key.

2. Run wama login and enter those credentials.

3. Create an instance in the [dashboard](https://dashboard.wa-ma.org) if you do not have one yet.

4. Run wama connect and scan the QR code with WhatsApp → Linked Devices.

5. After the instance shows connected, use wama send to queue messages.

Common commands

Credentials are stored in ~/.wama/config.json (Windows: %USERPROFILE%\.wama\config.json).

javascript

wama instances          # list linked numbers
wama use <instance_id>  # set default instance
wama status               # connection + public API key
wama send 966501234567 "Hello from CLI"
wama history -p 1 -l 20   # paginated message log