signalwire-builder

SignalWire Builder - Claude Code Plugin

A comprehensive Claude Code plugin that transforms Claude into an expert SignalWire developer, combining complete API documentation with practical production knowledge from real-world deployments.

Quick install

From inside a Claude Code session:

/plugin marketplace add signalwire/signalwire-claude
/plugin install signalwire-builder

Features

• Complete API Coverage: All SignalWire REST APIs, SWML, Relay SDK, AI Agents SDK, Video API (excludes deprecated LAML/CXML)
• Practical Production Knowledge: Best practices, patterns, and anti-patterns from 89 SignalWire training videos
• Multi-Language Examples: 110+ Python examples, 24+ JavaScript examples, 44+ SWML examples
• Workflow-Organized: Find what you need by developer workflow (calling, messaging, video, AI, etc.)
• Production-Ready Code: Complete working examples with error handling and security best practices
• Real-World Patterns: IVR systems, AI agents, video conferencing, context-aware transfers, MFA implementation

What's Included

Core Workflows (14,800+ lines of documentation)

Each workflow combines technical API documentation with practical implementation guidance:

Telephony Core:

1. Authentication & Setup - Credentials, MFA patterns, metadata for security, token management
2. Outbound Calling - REST API, CRM integration, appointment reminders, healthcare workflows
3. Inbound Call Handling - Complete SWML reference, loop protection, variable management, IVR patterns
4. Call Control - Context-aware transfers, screen pop, recording best practices, conference management
5. Messaging - SMS/MMS, Campaign Registry, templates, opt-in/opt-out, Relay SDK v4
6. Video - WebRTC integration, room management, Browser SDK, click-to-call widgets
7. Fabric & Relay - Subscribers, resource architecture, context routing, high availability
8. Webhooks & Events - Post-prompt analytics, webhook testing, transcription integration
9. Number Management - Campaign Registry compliance, number association, bulk management

AI Voice Agents (Voice AI):

• Voice AI Overview - Navigation hub and decision guide for AI agents
• AI Agent SDK Basics - Python SDK fundamentals, installation, tool decorator
• AI Agent Prompting - Best practices, RISE-M framework, anti-patterns
• AI Agent Functions - SWAIG patterns, progressive knowledge building, DataMap
• AI Agent Deployment - Traditional server, Docker, serverless (Lambda/GCF/Azure)
• AI Agent Patterns - Common reusable flows (data lookup, confirmation, MFA)
• AI Agent Error Handling - Robust error handling patterns
• AI Agent Security - Authentication, input validation, secrets management
• AI Agent Testing - swaig-test CLI, pytest patterns, integration testing
• AI Agent Debug Webhooks - Real-time monitoring and debugging

What Makes This Skill Different

Technical Knowledge (What APIs Do):

• REST API endpoints and parameters
• SWML method reference
• SDK function signatures
• Authentication formats

Practical Knowledge (How to Best Use Them):

• Best practices from production deployments
• Common patterns and real-world examples
• Anti-patterns and mistakes to avoid
• Testing and debugging strategies
• Performance optimization techniques
• Security patterns (metadata, encryption, MFA)

Knowledge Sources

• Technical Documentation: Official SignalWire REST APIs, SWML, SDKs
• Practical Wisdom: Analysis of 89 SignalWire training videos including:
  • LiveWire sessions
  • SignalWire in Seconds tutorials
  • ClueCon 2025 workshops
  • Digital Employees examples
  • Production deployment case studies

Key Principles Documented

1. Treat AI Like a Person, Not a Program - "How would you instruct your mother?" approach
2. Use Metadata for Security - Keep sensitive data out of LLM context
3. Test Continuously - AI behavior is probabilistic
4. Preserve Context Through Transfers - 72% of customers expect it
5. Implement Loop Protection - Always protect gather/prompt nodes

Installation

Option 1: Install from Marketplace (Recommended)

Install the plugin directly using Claude Code:

/plugin marketplace add signalwire/signalwire-claude
/plugin install signalwire-builder

The plugin will be installed to ~/.claude/plugins/signalwire-builder/ and will be available in all your Claude Code sessions.

Option 2: Manual Installation

Clone the repository and install manually:

# Clone the repository
git clone https://github.com/signalwire/signalwire-claude.git
cd signalwire-claude

# Run installer
./install.sh

Verify Installation

Restart Claude Code after installation. The plugin will automatically activate when you work with SignalWire applications.

Usage

Once installed, Claude will automatically use this plugin when: