Telnyx CLI Agent Skill
>- 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.
Install
one command, takes just this skill from the repositorynpx skills add https://github.com/team-telnyx/ai --skill telnyx-cliThe instruction itself
16 sections, as written by the authorTelnyx CLI
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.
Installation
# 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
Authentication
export TELNYX_API_KEY="KEY..."
The CLI reads TELNYX_API_KEY from your environment. Set it once in your shell profile.
Command Discovery
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
Command Structure
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.
Common Operations
Send an SMS
telnyx messages create \
--from +15551234567 \
--to +15559876543 \
--text "Hello from the CLI"
List phone numbers
telnyx phone-numbers list --page-size 25
Search for available numbers
telnyx available-phone-numbers list \
--country-code US \
--state CA \
--features sms
Order a phone number
telnyx number-orders create \
--phone-numbers +15551234567
Make an outbound call
telnyx calls create \
--connection-id 1234567890 \
--from +15551234567 \
--to +15559876543
List SIM cards
telnyx sim-cards list --page-size 10
Create an AI assistant
telnyx assistants create \
--name "Support Agent" \
--model telnyx_ai
Check account balance
telnyx balance get
Output Formats
# 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'
When to Use CLI vs SDK
| 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 |
Other skills for the same job
different authors, same section of the catalogue
Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).
Automatically creates user-facing changelogs from git commits by analyzing commit history, categorizing changes, and transforming technical commits into clear, customer-friendly release notes. Turns hours of manual changelog writing into minutes of automated generation.
Use when implementation is complete, all tests pass, and you need to decide how to integrate the work - guides completion of development work by presenting structured options for merge, PR, or cleanup
Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).
React Native and Expo best practices for building performant mobile apps. Use when building React Native components, optimizing list performance, implementing animations, or working with native modules. Triggers on tasks involving React Native, Expo, mobile performance, or native platform APIs.
React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.
Next.js best practices - file conventions, RSC boundaries, data patterns, async APIs, metadata, error handling, route handlers, image/font optimization, bundling
Use when starting feature work that needs isolation from current workspace or before executing implementation plans - creates isolated git worktrees with smart directory selection and safety verification
How to use it
Take team-telnyx/telnyx-cli from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.
The instructions reference brew, go.
Without those the skill loads but fails at the first command.