Skip to main content Startseite Ersteller jeremylongshore claude-code-plugins-plus-skills posthog-debug-bundle
posthog-debug-bundle Collect PostHog debug evidence for support tickets and troubleshooting.
Gathers SDK versions, API connectivity, event flow status, flag definitions,
and redacted configuration into a support-ready archive.
Trigger: "posthog debug", "posthog support bundle", "collect posthog logs",
"posthog diagnostic", "posthog not working debug".
Zur Installation springen Skills Marktplatz Entdecken und erkunden Sie KI-Skills, die von der Community erstellt wurden.
Verwandte Berufe SOC
Basierend auf der SOC-Berufsklassifikation
Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.
Prompt-Details anzeigen Ein direkter Befehl überspringt den Prüf-Prompt. Prüfen Sie die Quelle, bevor Sie ihn ausführen.
npx skills add https://github.com/jeremylongshore/claude-code-plugins-plus-skills --skill posthog-debug-bundleDer Befehl bleibt in einer Zeile. Scrollen Sie horizontal, um ihn vor dem Kopieren vollständig zu prüfen.
Sie bevorzugen eine lokale Kopie? Laden Sie die Dateien herunter, die SkillsMP derzeit vorliegen.
ZIP herunterladen Herunterladen... Mehr aus diesem Repository Implement user sign-up and sign-in flows with Clerk.
Use when building authentication UI, customizing sign-in experience,
or implementing OAuth social login.
Trigger with phrases like "clerk sign-in", "clerk sign-up",
"clerk login flow", "clerk OAuth", "clerk social login".
Implement session management and middleware with Clerk.
Use when managing user sessions, configuring route protection,
or implementing token refresh and custom JWT templates.
Trigger with phrases like "clerk session", "clerk middleware",
"clerk route protection", "clerk token", "clerk JWT".
Configure enterprise SSO, role-based access control, and organization management.
Use when implementing SSO integration, configuring role-based permissions,
or setting up organization-level controls.
Trigger with phrases like "clerk SSO", "clerk RBAC",
"clerk enterprise", "clerk roles", "clerk permissions", "clerk organizations".
name posthog-debug-bundle description Collect PostHog debug evidence for support tickets and troubleshooting.
Gathers SDK versions, API connectivity, event flow status, flag definitions,
and redacted configuration into a support-ready archive.
Trigger: "posthog debug", "posthog support bundle", "collect posthog logs",
"posthog diagnostic", "posthog not working debug".
allowed-tools Read, Bash(grep:*), Bash(curl:*), Bash(tar:*), Grep version 1.12.0 license MIT author Jeremy Longshore <jeremy@intentsolutions.io> tags ["saas","posthog","debugging"] compatibility Designed for Claude Code, also compatible with Codex and OpenClaw
PostHog Debug Bundle
Current State
!node --version 2>/dev/null || echo 'N/A'
!npm list posthog-js posthog-node 2>/dev/null | grep posthog || echo 'No PostHog SDK found'
Overview
Collect diagnostic evidence for PostHog support tickets. Gathers SDK versions, API connectivity, feature flag status, event flow verification, and redacted configuration. All secrets are automatically redacted.
Prerequisites
PostHog SDK installed in project
Access to environment variables
curl and jq available
Instructions
Step 1: Run Full Diagnostic Script
#!/bin/bash
set -euo pipefail
BUNDLE_DIR="posthog-debug-$(date +%Y%m%d-%H%M%S) "
mkdir -p "$BUNDLE_DIR "
echo "=== PostHog Debug Bundle ===" > "$BUNDLE_DIR /summary.txt"
echo "Generated: $(date -u +%Y-%m-%dT%H:%M:%SZ) " >> "$BUNDLE_DIR /summary.txt"
echo "" >> "$BUNDLE_DIR /summary.txt"
echo "--- Runtime Environment ---" >> "$BUNDLE_DIR /summary.txt"
echo "Node: $(node --version 2>/dev/null || echo 'not found') " >> "$BUNDLE_DIR /summary.txt"
echo "npm: $(npm --version 2>/dev/null || echo 'not found') " >> "$BUNDLE_DIR /summary.txt"
echo "Python: $(python3 --version 2>/dev/null || echo 'not found') "
"$BUNDLE_DIR /summary.txt"
echo
"OS: $(uname -srm) "
"$BUNDLE_DIR /summary.txt"
echo
""
"$BUNDLE_DIR /summary.txt"
echo
"--- PostHog SDK Versions ---"
"$BUNDLE_DIR /summary.txt"
"$BUNDLE_DIR /summary.txt"
echo
"No npm PostHog packages"
"$BUNDLE_DIR /summary.txt"
"Name|Version"
"$BUNDLE_DIR /summary.txt"
true
echo
""
"$BUNDLE_DIR /summary.txt"
echo
"--- API Connectivity ---"
"$BUNDLE_DIR /summary.txt"
echo
"US Cloud ingest: "
"$BUNDLE_DIR /summary.txt"
"%{http_code} (%{time_total}s)"
"$BUNDLE_DIR /summary.txt"
echo
""
"$BUNDLE_DIR /summary.txt"
echo
"EU Cloud ingest: "
"$BUNDLE_DIR /summary.txt"
"%{http_code} (%{time_total}s)"
"$BUNDLE_DIR /summary.txt"
echo
""
"$BUNDLE_DIR /summary.txt"
echo
"App API: "
"$BUNDLE_DIR /summary.txt"
"%{http_code} (%{time_total}s)"
"$BUNDLE_DIR /summary.txt"
echo
""
"$BUNDLE_DIR /summary.txt"
echo
""
"$BUNDLE_DIR /summary.txt"
echo
"--- Environment Variables (redacted) ---"
"$BUNDLE_DIR /summary.txt"
env
's/=.*/=***REDACTED***/'
"$BUNDLE_DIR /summary.txt"
echo
"No POSTHOG env vars found"
"$BUNDLE_DIR /summary.txt"
echo
""
"$BUNDLE_DIR /summary.txt"
echo
"--- API Key Types ---"
"$BUNDLE_DIR /summary.txt"
if
"${NEXT_PUBLIC_POSTHOG_KEY:-} "
then
echo
"Project key prefix: $(echo "$NEXT_PUBLIC_POSTHOG_KEY " | head -c 4) _..."
"$BUNDLE_DIR /summary.txt"
fi
if
"${POSTHOG_PERSONAL_API_KEY:-} "
then
echo
"Personal key prefix: $(echo "$POSTHOG_PERSONAL_API_KEY " | head -c 4) _..."
"$BUNDLE_DIR /summary.txt"
fi
echo
""
"$BUNDLE_DIR /summary.txt"
echo
"Bundle complete: $BUNDLE_DIR /"
"$BUNDLE_DIR /summary.txt"
Step 2: Test Event Capture Flow set -euo pipefail
RESPONSE=$(curl -s -w "\n%{http_code}" -X POST 'https://us.i.posthog.com/capture/' \
-H 'Content-Type: application/json' \
-d "{
\"api_key\": \"${NEXT_PUBLIC_POSTHOG_KEY} \",
\"event\": \"debug_bundle_test\",
\"distinct_id\": \"debug-$(date +%s) \",
\"properties\": {\"test\": true}
}" )
HTTP_CODE=$(echo "$RESPONSE " | tail -1)
BODY=$(echo "$RESPONSE " | head -1)
echo "Capture test: HTTP $HTTP_CODE "
echo "Response: $BODY "
Step 3: Check Feature Flag Status set -euo pipefail
curl -s -X POST 'https://us.i.posthog.com/decide/?v=3' \
-H 'Content-Type: application/json' \
-d "{
\"api_key\": \"${NEXT_PUBLIC_POSTHOG_KEY} \",
\"distinct_id\": \"debug-test\"
}" | jq '{
featureFlags: .featureFlags,
errorsWhileComputingFlags: .errorsWhileComputingFlags,
sessionRecording: (.sessionRecording != false)
}'
Step 4: Verify Admin API Access set -euo pipefail
if [ -n "${POSTHOG_PERSONAL_API_KEY:-} " ]; then
curl -s "https://app.posthog.com/api/projects/" \
-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY " | \
jq '[.[] | {id, name, created_at}]' > "$BUNDLE_DIR /projects.json" 2>/dev/null || \
echo "Personal API key failed" >> "$BUNDLE_DIR /summary.txt"
fi
Step 5: Package and Review set -euo pipefail
grep -rn "phc_\|phx_\|Bearer " "$BUNDLE_DIR /" | grep -v REDACTED | grep -v "prefix:" && \
echo "WARNING: Potential secret found — review before sharing" || \
echo "No secrets detected in bundle"
tar -czf "$BUNDLE_DIR .tar.gz" "$BUNDLE_DIR "
echo "Bundle created: $BUNDLE_DIR .tar.gz ($(du -h "$BUNDLE_DIR .tar.gz" | cut -f1) )"
Checklist Item Collected Purpose Node/Python versions Yes SDK compatibility PostHog SDK versions Yes Version-specific bugs API connectivity Yes Network/firewall issues Event capture test Yes End-to-end verification Feature flag status Yes Flag evaluation issues Environment vars (redacted) Yes Configuration problems Key type detection Yes Wrong key type errors
Error Handling Issue Cause Solution All connectivity fails Corporate firewall Check proxy settings, try VPN Capture returns non-200 Invalid API key Verify phc_ key in project settings /decide failsKey/host mismatch Ensure key matches the host region Personal API 401 Expired key Regenerate in Settings > Personal API Keys
Output
posthog-debug-YYYYMMDD-HHMMSS.tar.gz archive containing:
summary.txt — Runtime, SDK versions, connectivity, redacted configprojects.json — Project list (if personal key available)Test event capture and flag evaluation results
Resources
Next Steps For rate limit issues, see posthog-rate-limits.
