gh workflow list
 
# Include disabled workflows
gh workflow list --all
 
# JSON output
gh workflow list --json name,state,id

gh workflow view build.yml
gh workflow view build.yml --web
 
# View by ID
gh workflow view 12345

gh workflow disable build.yml
gh workflow enable build.yml

# Trigger on the default branch
gh workflow run build.yml
 
# Trigger on a specific branch
gh workflow run build.yml --ref feature-branch
 
# Pass input parameters (defined in the workflow YAML)
gh workflow run deploy.yml -f environment=staging -f version=1.2.0
 
# Pass inputs from a JSON file
gh workflow run deploy.yml --json < inputs.json

# Recent runs (all workflows)
gh run list
 
# Filter by workflow
gh run list --workflow build.yml
 
# Filter by branch
gh run list --branch main
 
# Filter by status
gh run list --status failure
gh run list --status success
gh run list --status in_progress
 
# Filter by user
gh run list --user octocat
 
# Limit
gh run list --limit 50
 
# JSON output
gh run list --json databaseId,status,conclusion,headBranch

# Interactive — choose a job to see its logs
gh run view 123456789
 
# View specific job logs
gh run view 123456789 --job 987654321
 
# Show only the log output
gh run view 123456789 --log
 
# Show only failed step logs
gh run view 123456789 --log-failed
 
# Open in browser
gh run view 123456789 --web

# Watch until completion
gh run watch 123456789
 
# Watch with live log output
gh run watch 123456789 --exit-status
 
# Watch the most recent run
gh run watch

# Rerun all jobs
gh run rerun 123456789
 
# Rerun only failed jobs
gh run rerun 123456789 --failed
 
# Rerun a specific job
gh run rerun 123456789 --job 987654321
 
# Enable debug logging
gh run rerun 123456789 --debug

gh run cancel 123456789

gh run delete 123456789

# Download all artifacts
gh run download 123456789
 
# Download to a specific directory
gh run download 123456789 --dir ./artifacts
 
# Download a specific artifact by name
gh run download 123456789 --name build-output
 
# Download by pattern
gh run download 123456789 --pattern "*-linux-*"

gh cache list
 
# Sort by size or last accessed
gh cache list --sort size
gh cache list --sort last_accessed
 
# Limit
gh cache list --limit 50
 
# JSON output
gh cache list --json key,sizeInBytes,lastAccessedAt

# Delete by key
gh cache delete <cache-key>
 
# Delete all caches
gh cache delete --all

# 1. Push your code
git push origin main
 
# 2. Watch the triggered run
gh run watch
 
# 3. If it fails, check the logs
gh run view --log-failed
 
# 4. Fix, push again, rerun
gh run rerun --failed
 
# 5. Download artifacts
gh run download --name build-output