retellai-debug-bundle

jeremylongshore's avatarfrom jeremylongshore

Collect Retell AI debug evidence for support tickets and troubleshooting.Use when encountering persistent issues, preparing support tickets,or collecting diagnostic information for Retell AI problems.Trigger with phrases like "retellai debug", "retellai support bundle","collect retellai logs", "retellai diagnostic".

⭐939stars🔀114forks📁View on GitHub🕐Updated Jan 11, 2026
[Debugging]

When & Why to Use This Skill

The Retell AI Debug Bundle is a specialized Claude skill designed to streamline the troubleshooting process for Retell AI integrations. It automates the collection of critical diagnostic evidence, including environment configurations, SDK versions, redacted application logs, and network connectivity status. By packaging this information into a secure, redacted bundle, it helps developers and support teams identify root causes faster and provides all necessary data for efficient support ticket resolution.

Use Cases

  • Preparing comprehensive diagnostic data before opening a Retell AI support ticket to minimize back-and-forth communication and accelerate resolution.
  • Troubleshooting persistent connectivity issues or API errors by performing automated network health checks against Retell AI endpoints.
  • Auditing environment configurations and SDK versions across different deployment stages to identify compatibility issues or version-specific bugs.
  • Securely gathering redacted logs and system information for internal incident response while ensuring sensitive API keys and PII are protected.
nameretellai-debug-bundle
description|
allowed-toolsRead, Bash(grep:*), Bash(curl:*), Bash(tar:*), Grep
version1.0.0
licenseMIT
authorJeremy Longshore <jeremy@intentsolutions.io>

Retell AI Debug Bundle

Overview

Collect all necessary diagnostic information for Retell AI support tickets.

Prerequisites

  • Retell AI SDK installed
  • Access to application logs
  • Permission to collect environment info

Instructions

Step 1: Create Debug Bundle Script

#!/bin/bash
# retellai-debug-bundle.sh

BUNDLE_DIR="retellai-debug-$(date +%Y%m%d-%H%M%S)"
mkdir -p "$BUNDLE_DIR"

echo "=== Retell AI Debug Bundle ===" > "$BUNDLE_DIR/summary.txt"
echo "Generated: $(date)" >> "$BUNDLE_DIR/summary.txt"

Step 2: Collect Environment Info

# Environment info
echo "--- Environment ---" >> "$BUNDLE_DIR/summary.txt"
node --version >> "$BUNDLE_DIR/summary.txt" 2>&1
npm --version >> "$BUNDLE_DIR/summary.txt" 2>&1
echo "RETELLAI_API_KEY: ${RETELLAI_API_KEY:+[SET]}" >> "$BUNDLE_DIR/summary.txt"

Step 3: Gather SDK and Logs

# SDK version
npm list @retellai/sdk 2>/dev/null >> "$BUNDLE_DIR/summary.txt"

# Recent logs (redacted)
grep -i "retellai" ~/.npm/_logs/*.log 2>/dev/null | tail -50 >> "$BUNDLE_DIR/logs.txt"

# Configuration (redacted - secrets masked)
echo "--- Config (redacted) ---" >> "$BUNDLE_DIR/summary.txt"
cat .env 2>/dev/null | sed 's/=.*/=***REDACTED***/' >> "$BUNDLE_DIR/config-redacted.txt"

# Network connectivity test
echo "--- Network Test ---" >> "$BUNDLE_DIR/summary.txt"
echo -n "API Health: " >> "$BUNDLE_DIR/summary.txt"
curl -s -o /dev/null -w "%{http_code}" https://api.retellai.com/health >> "$BUNDLE_DIR/summary.txt"
echo "" >> "$BUNDLE_DIR/summary.txt"

Step 4: Package Bundle

tar -czf "$BUNDLE_DIR.tar.gz" "$BUNDLE_DIR"
echo "Bundle created: $BUNDLE_DIR.tar.gz"

Output

  • retellai-debug-YYYYMMDD-HHMMSS.tar.gz archive containing:
    • summary.txt - Environment and SDK info
    • logs.txt - Recent redacted logs
    • config-redacted.txt - Configuration (secrets removed)

Error Handling

Item Purpose Included
Environment versions Compatibility check ✓
SDK version Version-specific bugs ✓
Error logs (redacted) Root cause analysis ✓
Config (redacted) Configuration issues ✓
Network test Connectivity issues ✓

Examples

Sensitive Data Handling

ALWAYS REDACT:

  • API keys and tokens
  • Passwords and secrets
  • PII (emails, names, IDs)

Safe to Include:

  • Error messages
  • Stack traces (redacted)
  • SDK/runtime versions

Submit to Support

  1. Create bundle: bash retellai-debug-bundle.sh
  2. Review for sensitive data
  3. Upload to Retell AI support portal

Resources

Next Steps

For rate limit issues, see retellai-rate-limits.