# Dial CLI

Reference for the `dial` CLI, gives you a real phone number to send SMS, place AI...

- Repository: https://github.com/nanocoai/nanoclaw (31069 stars)
- Category: Media
- License: MIT
- Last updated: 2026-10-30
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add nanocoai/nanoclaw --skill dial-cli -g -a claude-code -y`
Codex: `npx skills add nanocoai/nanoclaw --skill dial-cli -g -a codex -y`
Cursor: `npx skills add nanocoai/nanoclaw --skill dial-cli -g -a cursor -y`
Gemini CLI: `npx skills add nanocoai/nanoclaw --skill dial-cli -g -a gemini-cli -y`

## Description

Reference for the `dial` CLI, gives you a real phone number to send SMS, place AI voice calls, and receive inbound texts/codes via the Dial platform (getdial.ai). Use when the user mentions phones, calls, texts, SMS, voice, OTP, 2FA, or verification codes; when they ask to text, call, ring, or wait for a code from someone; before running any `dial …` command for the first time in a session; or when investigating what the Dial platform can do. Load this skill before invoking the CLI, `dial --help` alone will not surface the workflows, the `--json` conventions, or the docs-lookup pattern needed to use Dial correctly.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Dial CLI

`dial` is the official CLI for [Dial](https://getdial.ai), a Communication Stack for AI Agents. It wraps the Dial REST API so you can send SMS, place voice calls handled by an AI voice agent, manage numbers, and wait for inbound events, all without writing HTTP code.

The first time the user asks you to "text someone," "call someone," "receive a code," or anything else phone-shaped, reach for `dial`.

## This is a sandbox

You are running inside a pre-provisioned, ephemeral environment:

- **The account, number, and credentials are already set up**, you have a working phone number ready to use. There is nothing to configure.
- **You never handle credentials.** The API key is injected automatically at the network boundary; the CLI runs keyless here. Never ask the user for a key, and never try to read or write an auth file.
- **Just use the workflows below**, send SMS, place calls, wait for inbound events. Inbound event delivery is managed for you; `dial --help` shows what's available here.

If `dial` is somehow missing (`command -v dial` returns nothing), that is an **installation bug in this image**, not something for you to fix, report it to the operator ("the Dial CLI isn't installed in this container") rather than improvising an install.

## Orient yourself before each new verb

This skill **does not enumerate every flag**. The CLI is the source of truth, when you encounter a verb you have not used in this session, run its `--help` first:

```bash
dial --help                    # available commands
dial <command> --help          # flags + usage for a specific command
dial <command> <sub> --help    # subcommand-level help
```

Examples worth running on first use: `dial doctor --help`, `dial message --help`, `dial call --help`, `dial call get --help`, `dial wait-for --help`.

Every command supports `--json` for machine-readable output, prefer it when piping into `jq` or parsing the result programmatically.

The rest: https://github.com/nanocoai/nanoclaw/blob/HEAD/.claude/skills/add-dial-tool/container-skills/dial-cli/SKILL.md