supabase-debug-bundle

jeremylongshore's avatarfrom jeremylongshore

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

⭐878stars🔀101forks📁View on GitHub🕐Updated Jan 4, 2026

When & Why to Use This Skill

The Supabase Debug Bundle is a specialized Claude skill designed to automate the collection of diagnostic information and evidence for Supabase environments. It streamlines the troubleshooting process by gathering environment metadata, redacted logs, and configuration files into a secure, ready-to-use archive, significantly reducing the time required to resolve persistent issues or prepare comprehensive support tickets.

Use Cases

  • Support Ticket Preparation: Automatically compile all necessary technical data required by Supabase support teams to minimize back-and-forth communication and accelerate resolution times.
  • Incident Troubleshooting: Rapidly collect and redact application logs and environment info to identify root causes of database connectivity or SDK-related errors.
  • Diagnostic Auditing: Generate a point-in-time snapshot of system configurations and SDK versions to ensure environment consistency and assist in post-mortem analysis.
namesupabase-debug-bundle
description|
allowed-toolsRead, Bash(grep:*), Bash(curl:*), Bash(tar:*), Grep
version1.0.0
licenseMIT
authorJeremy Longshore <jeremy@intentsolutions.io>

Supabase Debug Bundle

Prerequisites

  • Supabase SDK installed
  • Access to application logs
  • Permission to collect environment info

See {baseDir}/references/implementation.md for detailed implementation guide.

Output

  • supabase-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

See {baseDir}/references/errors.md for comprehensive error handling.

Examples

See {baseDir}/references/examples.md for detailed examples.

Resources