# Fetch Action Logs

> Fetch and display logs for a GitHub Actions run. Use when the user asks to get, check, or view CI logs for a GitHub Actions run. Use when this capability is needed.

- Skill: `tomevault-io/fetch-action-logs` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/fetch-action-logs`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/fetch-action-logs/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/fetch-action-logs

---


# Fetch GitHub Actions Run Logs

## Finding the run ID

If no run ID is provided, list recent runs:

```bash
gh run list --limit 5
```

The run ID is the numeric ID in the output (second to last column).

## Downloading logs

```bash
REPO=$(gh repo view --json nameWithOwner -q .nameWithOwner)

curl -L \
  -H "Authorization: Bearer $GITHUB_TOKEN" \
  -H "Accept: application/vnd.github+json" \
  "https://api.github.com/repos/$REPO/actions/runs/<RUN_ID>/logs" \
  -o /tmp/gh_logs.zip
```

## Extracting and displaying logs

```bash
rm -rf /tmp/gh_logs && unzip -o /tmp/gh_logs.zip -d /tmp/gh_logs/
```

Then read the relevant log files from `/tmp/gh_logs/` to show the user what happened.

## Getting logs for a specific job

```bash
curl -L \
  -H "Authorization: Bearer $GITHUB_TOKEN" \
  -H "Accept: application/vnd.github+json" \
  "https://api.github.com/repos/$REPO/actions/jobs/<JOB_ID>/logs" \
  -o /tmp/gh_job.log
```

The job endpoint returns plain text instead of a zip.

---
> Source: [finbarrtimbers/llamax](https://github.com/finbarrtimbers/llamax) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-04 -->