Wacli: WhatsApp from Your Terminal

Ever find yourself context-switching between your terminal and your phone just to check a quick WhatsApp message? Or maybe you need to send a notification from a script, but email feels too formal and setting up a whole bot framework is overkill. If that sounds familiar, there's a new tool that bridges that gap in the most developer-friendly way possible.

Enter Wacli, a clever CLI that lets you interact with WhatsApp directly from your command line. It turns your terminal into a WhatsApp client, and it's as simple and powerful as it sounds.

What It Does

Wacli is a command-line interface for WhatsApp Web. It uses the whatsapp-web.js library to create a headless session that you can control entirely from your terminal. You can send messages to individuals or groups, receive incoming messages, and see conversations scroll by in your shell—all without leaving your development environment.

Why It's Cool

The immediate appeal is the sheer convenience. For developers who live in the terminal, minimizing alt-tabs is a quality-of-life win. But Wacli gets more interesting when you think about automation.

Imagine getting pinged in your terminal when a CI/CD pipeline fails, with logs attached. Or having a script that sends you a daily digest from a server. You could even build simple monitoring or alert systems that notify you or your team in a WhatsApp group. It leverages a communication channel everyone already uses and checks constantly.

The implementation is pragmatic. It runs a real browser session in the background (using Puppeteer), so it's interacting with WhatsApp Web just like a human would. This approach sidesteps the need for the official, often restrictive, WhatsApp Business API for simple, personal use cases.

How to Try It

Getting started is straightforward. You'll need Node.js installed.

First, clone the repository and install the dependencies:

git clone https://github.com/steipete/wacli.git
cd wacli
npm install

Then, run it:

node index.js

On the first run, you'll need to authenticate by scanning a QR code with your phone. The session is saved, so you won't have to do this every time. Once you're in, you can start sending messages directly from your shell.

Check out the GitHub repository for more details and the full command reference.

Final Thoughts

Wacli is one of those tools that feels obvious in hindsight. It solves a small but frequent annoyance for developers and opens the door to some neat, lightweight automation. It's not meant for spamming or bulk messaging—it's a personal productivity tool. If you've ever wanted to keep your flow state intact or pipe a curl output directly to a chat, this is your solution. Give it a spin; it might just become a quiet, useful part of your terminal toolkit.

Follow us for more cool projects: @githubprojects