GitHub AE is currently under limited release. Please contact our Sales Team to find out more.

Viewing workflow run history

You can view logs for each run of a workflow. Logs include the status for each job and step in a workflow.

GitHub Actions is available with GitHub Free, GitHub Pro, GitHub Free for organizations, GitHub Team, GitHub Enterprise Cloud, GitHub Enterprise Server, and GitHub AE. GitHub Actions is not available for private repositories owned by accounts using legacy per-repository plans.

In this article

Note: GitHub Actions is currently in beta for GitHub AE.

Viewing workflow run history on GitHub

Read access to the repository is required to perform these steps.

  1. On GitHub AE, navigate to the main page of the repository.
  2. Under your repository name, click Actions. Actions tab in the main repository navigation
  3. In the left sidebar, click the workflow you want to see. Workflow list in left sidebar
  4. From the list of workflow runs, click the name of the run you want to see. Name of workflow run

Viewing workflow run history with GitHub CLI

For information on setting up GitHub CLI, see "Managing GitHub Actions with GitHub CLI."

Viewing recent workflow runs

To list the recent workflow runs, use the run list subcommand.

gh run list

To specify the maximum number of runs to return, you can use the -L or --limit flag . The default is 10.

gh run list --limit 5

To only return runs for the specified workflow, you can use the -w or --workflow flag. Replace workflow with either the workflow name, workflow ID, or workflow file name. For example, "Link Checker", 1234567, or "link-check-test.yml".

gh run list --workflow workflow

Viewing details for a specific workflow run

To display details for a specific workflow run, use the run view subcommand. Replace run-id with the ID of the run that you want to view. If you don't specify a run-id, GitHub CLI returns an interactive menu for you to choose a recent run.

gh run view run-id

To include job steps in the output, use the -v or --verbose flag.

gh run view run-id --verbose

To view details for a specific job in the run, use the -j or --job flag. Replace job-id with the ID of the job that you want to view.

gh run view --job job-id

To view the full log for a job, use the --log flag.

gh run view --job job-id --log

Use the --exit-status flag to exit with a non-zero status if the run failed. For example:

gh run view 0451 --exit-status && echo "run pending or passed"

Did this doc help you?

Privacy policy

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

Or, learn how to contribute.