providers/claude/plugin/skills/telnyx-cli/SKILL.md
Use the Telnyx CLI to manage phone numbers, send messages, make calls, and access all Telnyx APIs from the terminal. 946 commands auto-generated from the OpenAPI spec — every API endpoint is a CLI command.
npx skillsauth add team-telnyx/ai telnyx-cliInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
The Telnyx CLI provides command-line access to the entire Telnyx API. Every API endpoint maps to a CLI command — 946 commands covering messaging, voice, numbers, IoT, AI, and more.
# Homebrew (macOS/Linux)
brew install telnyx/tap/telnyx
# Go install
go install github.com/team-telnyx/telnyx-go/cmd/telnyx@latest
# Or download a binary from GitHub releases:
# https://github.com/team-telnyx/telnyx-go/releases
export TELNYX_API_KEY="KEY..."
The CLI reads TELNYX_API_KEY from your environment. Set it once in your shell profile.
The CLI is fully self-documenting. Use --help at any level to explore:
# Top-level resource list
telnyx --help
# Commands for a specific resource
telnyx messages --help
# Full usage for a specific command
telnyx messages create --help
Commands follow a consistent pattern:
telnyx <resource> <action> [--flag value ...]
Resources match API paths. Actions are list, create, get, update, delete, and resource-specific verbs.
telnyx messages create \
--from +15551234567 \
--to +15559876543 \
--text "Hello from the CLI"
telnyx phone-numbers list --page-size 25
telnyx available-phone-numbers list \
--country-code US \
--state CA \
--features sms
telnyx number-orders create \
--phone-numbers +15551234567
telnyx calls create \
--connection-id 1234567890 \
--from +15551234567 \
--to +15559876543
telnyx sim-cards list --page-size 10
telnyx assistants create \
--name "Support Agent" \
--model telnyx_ai
telnyx balance get
# Default: human-readable table
telnyx phone-numbers list
# JSON output for scripting
telnyx phone-numbers list --format json
# Pipe to jq for filtering
telnyx phone-numbers list --format json | jq '.data[].phone_number'
| Use case | Recommended | |----------|-------------| | Quick one-off operations | CLI | | Shell scripts and automation | CLI | | Application code | SDK (Python, JS, Go, Java, Ruby) | | Interactive exploration | CLI | | CI/CD pipelines | CLI or SDK | | Complex business logic | SDK |
development
Use when an agent must join, observe, react in, transcribe, summarize, or follow up on a Zoom, Google Meet, Microsoft Teams, or Webex meeting with Telnyx Meeting Bot. Handles vague requests, request-specific live polling, name/phrase and semantic triggers, explicitly authorized speak/chat actions, recovery, and all implemented transcript artifact types.
development
Use when an agent must join, observe, react in, transcribe, summarize, or follow up on a Zoom, Google Meet, Microsoft Teams, or Webex meeting with Telnyx Meeting Bot. Handles vague requests, request-specific live polling, name/phrase and semantic triggers, explicitly authorized speak/chat actions, recovery, and all implemented transcript artifact types.
development
Generate speech from text using Telnyx and third-party TTS providers (AWS, Azure, ElevenLabs, MiniMax, Resemble, Rime, xAI). Returns base64-encoded audio or a binary stream. Also lists available voices per provider.
development
Transcribe audio to text via the OpenAI-compatible transcription endpoint. Supports multiple models, languages, and keyword biasing. Also lists available speech-to-text providers and service types.