Dial

@getdial/cli

Dial の公式コマンドラインインターフェイスです。AI エージェント向けの通信スタックである Dial を使って、電話番号の取得、SMS の送信、AI 音声通話の発信、受信イベントへの応答をすべてターミナルから行えます。この CLI は Dial REST API をラップしているため、HTTP コードを書く必要はありません。

インストール

npm からグローバルにインストールします。

npm install -g @getdial/cli

または、CLI をインストールし、サインアップの手順を案内するブートストラップスクリプトを使用します。

curl -fsSL https://getdial.ai/install | bash

Node.js 22.19+ が必要です。

クイックスタート

dial auth login [email protected]               # email a 6-digit sign-up code
dial auth verify-otp --code 123456            # verify your email
dial auth register-number +14155550123        # text a code to your phone
dial auth verify-otp --number --code 654321   # verify your phone — creates the account
dial doctor                                   # check account state and what to do next

アカウントの作成には、確認済みのメールアドレスと確認済みの電話番号が必要です。各手順で次に実行するコマンドが表示されるため、手順を覚えておく必要はありません。

すでにアカウントをお持ちの場合、サインインに必要なのは最初の 2 つの手順だけです。電話番号を再度求められることはありません。

登録した電話番号は SMS を受信でき、そのアカウントに永久に紐付けられます。1 つの電話番号で登録できる Dial アカウントは 1 つだけです。Dial の電話番号は使用できません。

アカウントが作成されると、API キーがローカルに保存され、CLI によって自動的に使用されます。最初の電話番号には、デフォルトの着信音声エージェント用プロンプトが設定されます。dial number set <number> --inbound-instruction "..." で変更できます。

# Send an SMS
dial message --to +14155550123 --body "Hello from Dial"

# Place an AI voice call
dial call --to +14155550123 --outbound-instruction "You are a helpful scheduling assistant."

# Wait for an inbound event (e.g. a verification code)
dial wait-for message.received --field to=+14155550123

コマンド

コマンド	説明
dial doctor	アカウントの状態と次に行うことを表示します。
dial auth login <email>	6 桁のサインアップコードをメールで送信します。--coupon <code> を指定すると、サインアップの一時停止中でもサインアップでき、クーポンのクレジットが追加されます。
dial auth verify-otp --code <code>	メールで届いたコードを確認します。--number を指定した場合は、SMS で届いたコードを確認します。
dial auth register-number <phone>	アカウントに紐付ける電話番号にコードを SMS で送信します。
dial number list	アカウントの電話番号を一覧表示します。
dial number purchase	追加の電話番号を購入します。
dial number set <number>	電話番号の着信時の指示を更新します。
dial message	SMS を送信します。
dial message list	最近のメッセージを一覧表示します。
dial message reply	メッセージに返信またはリアクションします。
dial call	AI 音声通話を発信します。
dial call list	最近の通話を一覧表示します。
dial call get <id>	指定した通話のステータス、通話時間、文字起こしを取得します。
dial wait-for <event>	一致するアカウントイベントが届くまで待機します。
dial listen install	バックグラウンドイベントデーモンをインストールします。
dial listen status	デーモンの状態と最近のイベントを表示します。
dial listen uninstall	デーモンを停止して削除します。
dial local-target add url <url>	イベントをローカルの HTTP エンドポイントに一斉転送します。
dial local-target add cmd <path>	イベントごとに実行ファイルを 1 回実行します。
dial local-target list	登録済みの一斉転送先を一覧表示します。
dial local-target remove <id>	一斉転送先の登録を解除します。
dial mcp	すべてのコマンドをエージェントツールとして公開する、ローカルの stdio MCP サーバーを実行します。

コマンドツリー全体を確認するには dial --help を、特定のコマンドのフラグを確認するには dial <command> --help を実行します。dial mcp（標準出力で JSON-RPC を使用）を除き、すべてのコマンドで機械可読な出力を得るための --json を使用できます。

設定

変数	説明
DIAL_API_URL	デフォルト以外の Dial デプロイ先を指定します。

API キーは ~/.local/share/dial/auth.json に保存されます（XDG_DATA_HOME が設定されている場合はそれに従います）。

AI エージェントからの利用

この CLI には、AI コーディングエージェントに dial の操作方法を教える スキル が付属しています。オンボーディング時に、エージェントの設定へインストールします。

dial auth verify-otp --code 123456 --agent claude-code

対応エージェント：claude-code、cursor、codex、opencode、pi、openclaw、nanoclaw、hermes。

ローカル MCP サーバー

dial mcp は、stdio 経由でローカルの Model Context Protocol サーバーを実行し、すべてのコマンドをエージェントツールとして公開します。ローカル MCP クライアントのサーバーコマンドに dial mcp を指定してください。dial auth verify-otp で保存した API キーが再利用されます（OAuth も設定も不要です）。これはホスト型の リモート MCP サーバーに対応するローカル版で、同じ運用ツールに加え、ローカル専用の動詞（auth、listen、local-target）も使用できます。

# Claude Code, for example
claude mcp add dial -- dial mcp

クライアントのセットアップについては、ローカル MCP のドキュメントをご覧ください。

ドキュメント

すべてのドキュメントは docs.getdial.ai にあります。CLI リファレンスやlisten サービスのガイドもご覧いただけます。

ライセンス

MIT