CLI Reference

Command Line Interface

Complete reference for all available sms-dev CLI commands.

Installation

Global Installation

npm install -g @relay-works/sms-dev

Project Installation

npm install --save-dev @relay-works/sms-dev

Core Commands

sms-dev start

Available

Start the sms-dev development environment (API server + Virtual Phone UI).

Usage

sms-dev start [options]

Options

-c, --config <file>Configuration file path
-p, --api-port <port>API server port (default: 4001)
-u, --ui-port <port>UI server port (default: 4000)
--no-uiStart only the API server
--webhook-url <url>Webhook URL for testing
--verboseEnable verbose logging
--show-configShow resolved configuration and exit

Examples

Start with default ports:

sms-dev start

Start with webhook URL:

sms-dev start --webhook-url http://localhost:3000/webhook

Start API only (no UI):

sms-dev start --no-ui --verbose

sms-dev stop

Available

Stop the sms-dev server and all running processes.

Usage

sms-dev stop

sms-dev status

Available

Check the status of sms-dev servers and display connection information.

Usage

sms-dev status

Configuration Commands

sms-dev init

Available

Generate a sample configuration file for customizing sms-dev behavior.

Usage

sms-dev init [options]

Options

-f, --forceOverwrite existing configuration file
--jsonGenerate JSON configuration instead of JavaScript

Examples

Generate JavaScript config:

sms-dev init

Generate JSON config:

sms-dev init --json

sms-dev config

Available

Show the current resolved configuration from all sources.

Usage

sms-dev config [options]

Options

-c, --config <file>Configuration file path

Help Commands

sms-dev docs

Available

Display documentation links and quick command reference.

Usage

sms-dev docs

sms-dev --help

Available

Display help information for all commands and options.

Usage

sms-dev --help

Next Steps

Configuration Guide

Learn how to customize sms-dev with configuration files and environment variables.

Read Configuration Guide →

API Reference

Explore the complete API reference for integrating with sms-dev.

View API Reference →