figma-debug-bundle

name	figma-debug-bundle
description	Collect Figma API diagnostic evidence for support tickets and troubleshooting. Use when encountering persistent issues, preparing support tickets, or collecting diagnostic information for Figma API problems. Trigger with phrases like "figma debug", "figma support bundle", "collect figma logs", "figma diagnostic".
allowed-tools	Read, Bash(curl:*), Bash(tar:*), Bash(node:*), Grep
version	1.6.0
license	MIT
author	Jeremy Longshore <[e-mail]>
tags	["saas","figma"]
compatibility	Designed for Claude Code

Figma Debug Bundle

Overview

Collect all diagnostic data needed to troubleshoot Figma REST API issues or submit a support request. Outputs a redacted archive with connectivity tests, token validation, rate limit status, and API response samples.

Prerequisites

• FIGMA_PAT environment variable set
• curl and jq available
• A Figma file key to test against

Instructions

Step 1: Create Debug Bundle Script

#!/bin/bash
# figma-debug-bundle.sh
set -euo pipefail

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

echo "=== Figma Debug Bundle ===" | tee "$BUNDLE_DIR/summary.txt"
echo "Generated: $(date -u +%Y-%m-%dT%H:%M:%SZ)" >> "$BUNDLE_DIR/summary.txt"
echo "---" >> "$BUNDLE_DIR/summary.txt"

# 1. Environment info
echo "--- Environment ---" >> "$BUNDLE_DIR/summary.txt"
echo "Node: $(node --version 2>/dev/null || echo 'not installed')" >> "$BUNDLE_DIR/summary.txt"
echo "npm: $(npm --version 2>/dev/null || echo 'not installed')" >> "$BUNDLE_DIR/summary.txt"
echo "OS: $(uname -srm)" >> 
  >> 
  >> 


  >> 
  >> 
 -n  >> 
curl -s -o  -w  \
  -H  \
  https://api.figma.com/v1/me >> 
  >> 


 [ -n  ]; 
   -n  >> 
  curl -s -o  -w  \
    -H  \
     >> 
    >> 



  >> 
  >> 
curl -s -D  -o /dev/null \
  -H  \
  https://api.figma.com/v1/me
grep -iE   >>  2>/dev/null ||   >> 


  >> 
  >> 

 [ -f  ]; 
  jq  \
     >  2>/dev/null || 
   -f 



 -f 

  >> 


tar -czf  
 -rf