glab-job

name

glab-job

description

Download CI/CD job artifacts from GitLab pipelines using the glab CLI. Use this skill whenever the user wants to download build artifacts, test reports, compiled binaries, or any files produced by a CI/CD job. Trigger on phrases like "download build artifacts", "get the test report from CI", "download the compiled binary from the pipeline", "fetch job artifacts", or any GitLab CI artifact download task.

GitLab CI Job Artifact Management

Use glab job artifact to download files produced by CI/CD jobs (build outputs, test reports, binaries, etc.).

Download Artifacts

# Download artifacts from a specific job on a branch
glab job artifact <branch-or-ref> <job-name>

# Examples
glab job artifact main build
glab job artifact main test-report
glab job artifact feature/login unit-tests

# Download to a specific directory
glab job artifact main build -p ./dist

# List artifact paths without downloading
glab job artifact main build -l

Arguments:

• <branch-or-ref> the branch, tag, or MR ref (e.g., main, v1.2.0, refs/merge-requests/42/head)
• <job-name> the exact job name as defined in .gitlab-ci.yml

Key flags:

• -p / --path destination directory (default: ./)
• -l / --list-paths list artifact paths without downloading

Typical Workflow

# 1. Check what jobs are available on a branch
glab ci list -r main -O json | jq '.[0].id'

# 2. View the pipeline to find job names
glab ci view

# 3. Download the artifacts
glab job artifact main build -p ./artifacts

# 4. Inspect downloaded files
ls ./artifacts/

Common Use Cases

# Download compiled binary from main branch
glab job artifact main build -p ./bin

# Download test coverage report
glab job artifact main coverage-report -p ./reports

# Download Docker image tarball
glab job artifact main docker-build -p ./images

# Check what's in an artifact before downloading
glab job artifact main build -l

Behavior Guidelines

1. Job name: The job name must match exactly what's in .gitlab-ci.yml. Use glab ci view to browse available jobs and their names.
2. Latest pipeline: This command downloads artifacts from the most recent pipeline on the given ref.
3. Destination: Suggest a descriptive -p path to avoid cluttering the working directory.
4. List first: For large artifacts, recommend -l first to verify the artifact contents before downloading.
5. MR artifacts: Use refs/merge-requests/<iid>/head as the ref to get artifacts from an MR pipeline.