gh Verified current stable Not installed? Version Control

Gh / Interactively Select And View Run Information

Interactively Select And View Run Information

Interactively view details of GitHub Actions runs.

$
Terminal
gh run view

When To Use

During a critical deployment phase to verify workflow execution.

Pro Tip

Use `--json` to dump run details in JSON format for further scripting.

Anatomy of Output

Understanding the result

Run ID: 12345 Run Identifier

Unique identifier for the run.

Status: completed Run Status

Final state of the initiated workflow.

Created at: 2023-10-01T12:34:56Z Timestamp

Precise time of the workflow run.

Power User Variants

Optimized versions

gh run view --json conclusion

Retrieve conclusion status of the run in JSON.

gh run view --log --json

Fetch job logs along with detailed run info in JSON.

Troubleshooting

Common pitfalls

Error: No runs found for the specified filter.

Solution: Check workflow run number or filters.

Error: API rate limit exceeded for user.

Solution: Wait for rate limit reset or authenticate with a higher rate limit.

Error: Permission denied for accessing the repository.

Solution: Ensure you have correct access rights.

Command Breakdown

What each part is doing

gh
Base Command
The executable that performs this operation. Here it runs Gh before the shell applies any redirect operators.

Alternative Approaches

Comparable commands in other tools

Alternative version control tools for the same job.