| name | groq-debug-bundle |
| description | Collect Groq debug evidence for support tickets and troubleshooting.
Use when encountering persistent issues, preparing support tickets,
or collecting diagnostic information for Groq problems.
Trigger with phrases like "groq debug", "groq support bundle",
"collect groq logs", "groq diagnostic".
|
| allowed-tools | Bash(grep:*), Bash(curl:*), Bash(tar:*) |
| version | 1.11.0 |
| license | MIT |
| author | Jeremy Longshore <jeremy@intentsolutions.io> |
| tags | ["saas","groq","debugging"] |
| compatibility | Designed for Claude Code, also compatible with Codex and OpenClaw |
Groq Debug Bundle
Current State
!node --version 2>/dev/null || echo 'N/A'
!python3 --version 2>/dev/null || echo 'N/A'
!npm list groq-sdk 2>/dev/null | grep groq-sdk || echo 'groq-sdk not installed'
Overview
Collect all diagnostic information needed to resolve Groq API issues. Produces a redacted support bundle (a .tar.gz) with environment info, SDK version, connectivity test results, rate limit headers, per-model latency, and redacted application logs — everything a Groq support engineer needs, with secrets masked before the archive is written.
Prerequisites
GROQ_API_KEY set in environmentcurl and jq available- Access to application logs (optional — the log step is skipped if
logs/ is absent)
Instructions
The bundle is assembled by a six-step shell script. Each step appends to a file inside a timestamped $BUNDLE_DIR; the final step tars it and deletes the working copy. Run the steps in order in one shell, or paste the whole sequence into a script.
- Environment — capture OS, Node/Python versions, installed Groq SDK versions, and a masked key fingerprint (length + 4-char prefix only, never the key).
- Connectivity — hit
GET /openai/v1/models to confirm auth and count available models.
- Rate limits — send a 1-token completion and grab the
x-ratelimit-*, retry-after, and x-request-id response headers.
- Latency — time a minimal completion against each model of interest.
- Log extraction — grep recent Groq/429/rate-limit errors from
logs/*.log and mask any gsk_ keys and .env values.
- Package —
tar -czf the directory, remove the working copy, and print a review reminder.
The skeleton of Step 1 (the rest is in the full walkthrough):
#!/bin/bash
set -euo pipefail
BUNDLE_DIR="groq-debug-$(date +%Y%m%d-%H%M%S)"
mkdir -p ""
