Merge #6766: docs: add GitHub CI debugging commands to CLAUDE.md

PastaPastaPasta · PastaPastaPasta · commit 54c5f632ad9c · 2025-07-20T13:40:41.000-05:00
996a7ec docs: add GitHub CI debugging commands to CLAUDE.md (pasta) Pull request description: ## Summary - Add comprehensive GitHub CI debugging commands using `gh` CLI to CLAUDE.md - Include examples for checking PR status, filtering failed jobs, and fetching logs - Provide practical commands for debugging common CI issues ## Background During testing, Claude is generally knowledgeable and effective when using `gh`, but it appears that fetching CI logs is a weakness. Before this change, Claude was unable to fetch CI logs consistently when helping with CI debugging tasks. This documentation provides the necessary `gh` CLI commands to enable reliable CI log access and debugging workflows. ## Test plan - [x] Verify commands work with existing PRs - [x] Test log fetching functionality - [x] Confirm JSON filtering works as expected ACKs for top commit: UdjinM6: utACK 996a7ec kwvg: utACK 996a7ec Tree-SHA512: d28b63a757582d75e32a6317f1bd7be1b48540892c3aaf80848a20c35b144a82fbb846085a6bcf7cf90ca952ee4b7b638a420425b655305f50b9182cc4720ea4
diff --git a/CLAUDE.md b/CLAUDE.md
@@ -229,6 +229,25 @@ perf report -i /path/to/datadir/test.perf.data --stdio | c++filt
 valgrind --leak-check=full ./src/dashd
 ```
 
+### GitHub CI Debugging with `gh` CLI
+
+```bash
+# Get detailed check info with JSON output
+gh pr checks <PR_NUMBER> --json name,state,link,description
+
+# Filter for failed or pending checks
+gh pr checks <PR_NUMBER> --json name,state,link --jq '.[] | select(.state == "FAILURE" or .state == "PENDING")'
+
+# View logs from a specific CI job
+gh api repos/dashpay/dash/actions/jobs/<JOB_ID>/logs
+
+# Filter failed jobs and steps from a run
+gh run view <RUN_ID> --json jobs --jq '.jobs[] | select(.conclusion == "failure") | {name, conclusion}'
+
+# Example: Get lint failure logs for PR 6691
+# gh api repos/dashpay/dash/actions/jobs/46274126203/logs
+```
+
 ## Branch Structure
 
 - `master`: Stable releases
