@sendblue/cli
v0.7.5
Published
Sendblue CLI — iMessage numbers for agents
Downloads
1,978
Maintainers
Readme
Sendblue CLI
iMessage numbers for AI agents. Set up an iMessage-enabled phone number and start sending messages in under a minute.
Install
npm install -g @sendblue/cliRequires Node.js 18+.
Quick Start
# Create an account and get an iMessage number
sendblue setup
# Send a message
sendblue send +15551234567 'Hello from Sendblue!'Commands
sendblue setup
Create a new Sendblue account. Walks you through email verification, company name, and adding your first contact.
# Interactive (recommended for first time)
sendblue setup
# Non-interactive (for CI/scripts)
sendblue setup --email [email protected] # sends verification code, exits
sendblue setup --email [email protected] --code 12345678 --company my-co --contact +15551234567| Flag | Description |
|------|-------------|
| --email <email> | Email address |
| --code <code> | 8-digit verification code |
| --company <name> | Company name (lowercase, hyphens/underscores, 3-64 chars) |
| --contact <number> | First contact phone number (E.164 format) |
sendblue login
Log in to an existing account.
sendblue loginsendblue send <number> <message>
Send an iMessage.
sendblue send +15551234567 'Hey, your order shipped!'sendblue messages
View recent messages.
sendblue messages
sendblue messages -n +15551234567 --limit 20
sendblue messages --inbound| Flag | Description |
|------|-------------|
| -n, --number <number> | Filter by contact |
| -l, --limit <count> | Number of messages (default: 10) |
| --outbound | Show only sent messages |
| --inbound | Show only received messages |
sendblue add-contact <number>
Add a contact to your account.
sendblue add-contact +15551234567sendblue contacts
List all contacts and their verification status.
sendblue status
Check your account status and plan.
sendblue whoami
Show current credentials and verify they're valid.
Credentials
Credentials are stored in ~/.sendblue/credentials.json with 600 permissions (owner read/write only). Run sendblue whoami to see the current config path.
