Skip to content

Commit 54c5f63

Browse files
Merge #6766: docs: add GitHub CI debugging commands to CLAUDE.md
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
2 parents 7a549c4 + 996a7ec commit 54c5f63

File tree

1 file changed

+19
-0
lines changed

1 file changed

+19
-0
lines changed

CLAUDE.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -229,6 +229,25 @@ perf report -i /path/to/datadir/test.perf.data --stdio | c++filt
229229
valgrind --leak-check=full ./src/dashd
230230
```
231231

232+
### GitHub CI Debugging with `gh` CLI
233+
234+
```bash
235+
# Get detailed check info with JSON output
236+
gh pr checks <PR_NUMBER> --json name,state,link,description
237+
238+
# Filter for failed or pending checks
239+
gh pr checks <PR_NUMBER> --json name,state,link --jq '.[] | select(.state == "FAILURE" or .state == "PENDING")'
240+
241+
# View logs from a specific CI job
242+
gh api repos/dashpay/dash/actions/jobs/<JOB_ID>/logs
243+
244+
# Filter failed jobs and steps from a run
245+
gh run view <RUN_ID> --json jobs --jq '.jobs[] | select(.conclusion == "failure") | {name, conclusion}'
246+
247+
# Example: Get lint failure logs for PR 6691
248+
# gh api repos/dashpay/dash/actions/jobs/46274126203/logs
249+
```
250+
232251
## Branch Structure
233252

234253
- `master`: Stable releases

0 commit comments

Comments
 (0)