Collect CodeRabbit debug evidence for support tickets and troubleshooting.
Use when encountering persistent issues, preparing support tickets,
or collecting diagnostic information for CodeRabbit problems.
Trigger with phrases like "coderabbit debug", "coderabbit support bundle",
"coderabbit diagnostic", "coderabbit not working evidence".
Collect CodeRabbit debug evidence for support tickets and troubleshooting.
Use when encountering persistent issues, preparing support tickets,
or collecting diagnostic information for CodeRabbit problems.
Trigger with phrases like "coderabbit debug", "coderabbit support bundle",
"coderabbit diagnostic", "coderabbit not working evidence".
Designed for Claude Code, also compatible with Codex and OpenClaw
CodeRabbit Debug Bundle
Overview
Collect all diagnostic information needed to troubleshoot CodeRabbit issues or file a support request. Since CodeRabbit is a GitHub/GitLab App (not an SDK), debugging focuses on: App installation status, .coderabbit.yaml configuration validity, PR review history, and GitHub webhook delivery logs.
Prerequisites
GitHub CLI (gh) authenticated
Repository admin access (for webhook logs)
Access to the GitHub repository where CodeRabbit is installed
Instructions
Step 1: Check CodeRabbit Installation Status
set -euo pipefail
OWNER="${1:-your-org}"
REPO="${2:-your-repo}"echo"=== CodeRabbit Debug Bundle ==="echo"Repository: $OWNER/$REPO"echo"Generated: $(date -u +%Y-%m-%dT%H:%M:%SZ)"echo""# Check if CodeRabbit App is installedecho"--- Installation Status ---"
INSTALL=$(gh api "repos/$OWNER/$REPO/installation" --jq '.app_slug' 2>/dev/null)
if [ "$INSTALL" = "coderabbitai" ]; thenecho"CodeRabbit App: INSTALLED"elseecho"CodeRabbit App: NOT INSTALLED"echo"Fix: Visit https://github.com/apps/coderabbitai to install"fi
set -euo pipefail
OWNER="${1:-your-org}"
REPO="${2:-your-repo}"echo""echo"--- Recent PR Review History ---"# Check last 10 closed PRs for CodeRabbit reviewsfor PR_NUM in $(gh api "repos/$OWNER/$REPO/pulls?state=all&per_page=10&sort=created&direction=desc" \
--jq '.[].number'); do
PR_TITLE=$(gh api "repos/$OWNER/$REPO/pulls/$PR_NUM" --jq '.title' 2>/dev/null)
PR_STATE=$(gh api "repos/$OWNER/$REPO/pulls/$PR_NUM" --jq '.state' 2>/dev/null)
CR_REVIEWS=$(gh api "repos/$OWNER/$REPO/pulls/$PR_NUM/reviews" \
--jq '[.[] | select(.user.login=="coderabbitai[bot]")] | length' 2>/dev/null || echo"0")
CR_COMMENTS=$(gh api "repos/$OWNER/$REPO/pulls/$PR_NUM/comments" \
--jq '[.[] | select(.user.login=="coderabbitai[bot]")] | length' 2>/dev/null || echo"0")
echo"PR #$PR_NUM ($PR_STATE): $CR_REVIEWS reviews, $CR_COMMENTS comments - $PR_TITLE"done
Step 4: Check Active Configuration via PR Comment
# On any open PR, post this comment:
@coderabbitai configuration
# CodeRabbit will reply with the active configuration as YAML.# Compare this with your .coderabbit.yaml to find discrepancies.# Discrepancies usually mean:# 1. YAML syntax error causing config to be ignored# 2. Org-level config overriding repo config# 3. Config not on the base branch (CodeRabbit reads from base branch)
Step 5: Check GitHub Webhook Deliveries
# In GitHub UI:1. Go to repo > Settings > Webhooks
2. Find the CodeRabbit webhook (coderabbit.ai endpoint)
3. Click "Recent Deliveries"
4. Look for:
- 200 response codes (success)
- 4xx/5xx codes (errors)
- Missing deliveries for PR events
# Common webhook issues:# - 401: App credentials expired → reinstall# - 404: Webhook URL changed → reinstall# - No deliveries: Webhook was deleted → reinstall App
Step 6: Compile Support Bundle
set -euo pipefail
OWNER="${1:-your-org}"
REPO="${2:-your-repo}"
BUNDLE="coderabbit-debug-$(date +%Y%m%d-%H%M%S).txt"
{
echo"=== CodeRabbit Debug Bundle ==="echo"Repository: $OWNER/$REPO"echo"Generated: $(date -u)"echo"Git branch: $(git branch --show-current 2>/dev/null || echo 'N/A')"echo"Git remote: $(git remote get-url origin 2>/dev/null || echo 'N/A')"echo""echo"--- .coderabbit.yaml ---"cat .coderabbit.yaml 2>/dev/null || echo"NOT FOUND"echo""echo"--- App Installation ---"
gh api "repos/$OWNER/$REPO/installation" 2>/dev/null || echo"NOT INSTALLED"echo""echo"--- Last 5 PRs ---"
gh api "repos/$OWNER/$REPO/pulls?state=all&per_page=5" \
--jq '.[] | "#\(.number) [\(.state)] \(.title) (by \(.user.login))"' 2>/dev/null
echo""echo"--- GitHub Actions Status ---"
gh run list --repo "$OWNER/$REPO" --limit 5 2>/dev/null || echo"N/A"
} > "$BUNDLE"echo"Debug bundle saved: $BUNDLE"echo"Review for sensitive data before sharing with support."
Output
Installation status verified
Configuration validated for syntax and completeness
