iblusend
v0.2.1
Published
Command-line client for the iBluSend iMessage API: send texts and media, read conversations and groups, manage contacts, opt-out and the AI bot, verify webhooks, prepare FaceTime calls. Built on @iblusend/sdk.
Maintainers
Readme
iblusend
The iBluSend iMessage API from your terminal. Built on @iblusend/sdk; no other dependencies. Node 18+.
npm install -g iblusend # or: npx iblusend <command>
iblusend login # paste an iblu_ key from Developer → API Keys
iblusend send +13035550101 "Hey! From the terminal 👋"
iblusend conversations get +13035550101
iblusend linesEvery command takes --json (print the API's data as-is) and --sandbox (use an iblu_test_ key — zero real sends). --sandbox takes --key first, then IBLUSEND_API_KEY only if it is an iblu_test_ key, then your stored sandbox key. It refuses a live key instead of sending for real. iblusend --help lists everything; iblusend <command> --help shows its flags.
| Area | Commands |
|---|---|
| Account | login · logout · whoami |
| Messaging | send · status · react · lines |
| Conversations | conversations list · conversations get · conversations messages |
| Groups | groups list · groups get · groups send · groups create · groups rename · groups photo · groups add · groups remove · groups leave · groups command |
| Contacts & bot | contacts list · contacts create · contacts update · opt-out get · opt-out set · bot get · bot set |
| Utility | capability · usage |
| Webhooks | webhooks verify · webhooks sign |
| Calls | calls lines · calls prepare · calls get · calls incoming · calls end · calls transfer |
Keys live in ~/.config/iblusend/config.json (mode 0600), or pass --key / set IBLUSEND_API_KEY. The file holds one live key and one sandbox key. login picks the slot from the key: an iblu_test_ key goes in the sandbox slot, any other key in the live slot, and login --sandbox refuses a live key. A read-only key is accepted too: login checks it against usage instead and warns that sending and listing lines will be refused. groups create does not return the new group's id: it appears in groups list once the Mac has made the group. Exit codes: 0 ok · 1 API error · 2 could not connect · 3 webhook signature mismatch · 64 usage.
Docs: https://iblusend.com/developers/docs/cli
