Send SMS from your terminal

  Open Source
v1.0.0

Send SMS from your terminal, scripts, and automated workflows

The official kwtSMS command-line tool. Send messages, monitor your balance, and manage sender IDs without ever opening a browser.

terminal
$

Works everywhere

Single self-contained binary. No runtime, no dependencies. Drop it and run.


Up and running in 30 seconds

Download the binary for your platform, move it to your PATH, then run kwtsms setup to store your credentials.

# Download, install, and configure
$ curl -Lo kwtsms-cli https://github.com/boxlinknet/kwtsms-cli/releases/latest/download/kwtsms-cli-linux-x64
$ chmod +x kwtsms-cli && sudo mv kwtsms-cli /usr/local/bin/
$ kwtsms setup
# Download, install, and configure
$ curl -Lo kwtsms-cli https://github.com/boxlinknet/kwtsms-cli/releases/latest/download/kwtsms-cli-linux-arm64
$ chmod +x kwtsms-cli && sudo mv kwtsms-cli /usr/local/bin/
$ kwtsms setup
# Download, install, and configure
$ curl -Lo kwtsms-cli https://github.com/boxlinknet/kwtsms-cli/releases/latest/download/kwtsms-cli-linux-armv7
$ chmod +x kwtsms-cli && sudo mv kwtsms-cli /usr/local/bin/
$ kwtsms setup
# Download, install, and configure
$ curl -Lo kwtsms-cli https://github.com/boxlinknet/kwtsms-cli/releases/latest/download/kwtsms-cli-darwin-x64
$ chmod +x kwtsms-cli && sudo mv kwtsms-cli /usr/local/bin/
$ kwtsms setup
# Download, install, and configure
$ curl -Lo kwtsms-cli https://github.com/boxlinknet/kwtsms-cli/releases/latest/download/kwtsms-cli-darwin-arm64
$ chmod +x kwtsms-cli && sudo mv kwtsms-cli /usr/local/bin/
$ kwtsms setup
# In PowerShell (run as Administrator)
> Invoke-WebRequest -Uri "https://github.com/boxlinknet/kwtsms-cli/releases/latest/download/kwtsms-cli-win-x64.exe" -OutFile "kwtsms-cli.exe"
> Move-Item kwtsms-cli.exe C:\Windows\System32\kwtsms-cli.exe
> kwtsms-cli setup

Built for real workflows

Common ways teams use kwtsms-cli in production today

CI/CD Pipeline Alerts

Get an SMS the moment a build fails or a deployment lands. Works with any CI tool that can execute shell commands.

OTP Delivery

Generate one-time codes in your backend and dispatch them instantly with a simple shell call or subprocess.

System Monitoring

Trigger on-call SMS alerts from cron jobs, uptime watchers, or log parsers when critical thresholds are breached.

Scheduled Reminders

Pair with cron to send appointment reminders, payment due notices, or daily digests at exactly the right time.


What it can do

A focused set of commands built for terminal users and automation engineers

Send SMS

Deliver messages to single or multiple recipients across Kuwait and internationally in one command.

Check Balance

Instantly see your current SMS credit balance. Ideal for scripts that need to verify credits before sending.

Manage Sender IDs

List all approved sender identities and pick the right branded name for every message type.

Coverage Check

View all active country prefixes your account can reach before committing to any outbound campaign.

Bulk Messaging

Send to large recipient lists at once. Auto-batching keeps you within rate limits with no extra code.

Script Friendly

JSON output, environment variable support, and a config file make embedding in any pipeline straightforward.

  AI-Native

Built for AI agents

kwtsms-cli ships with a native skill file for Claude Code. Once installed, AI agents can autonomously send SMS notifications as part of any workflow, with no extra integration code required.

  • Skill file bundled in the repository
  • Works with Claude Code agents out of the box
  • Agents can send, check balance, and verify coverage
  • JSON output makes tool responses machine-readable
View on GitHub
AI agent workflow
Task from user:
"Send order confirmation to the customer"
$ kwtsms send --to 96598765432 --sender MyShop --msg "Order #8821 confirmed"
✓ Sent  [1/1 recipients]

Full documentation on GitHub

macOS and Windows installers, all CLI flags, configuration examples, and release notes are in the repository.

  boxlinknet/kwtsms-cli