1GH-RUN-VIEW(1)                 GitHub CLI manual                GH-RUN-VIEW(1)
2
3
4

NAME

6       gh-run-view - View a summary of a workflow run
7
8
9

SYNOPSIS

11       gh run view [<run-id>] [flags]
12
13
14

OPTIONS

16       --exit-status
17              Exit with non-zero status if run failed
18
19
20       -j, --job <string>
21              View a specific job ID from a run
22
23
24       -q, --jq <expression>
25              Filter JSON output using a jq expression
26
27
28       --json <fields>
29              Output JSON with the specified fields
30
31
32       --log  View full log for either a run or specific job
33
34
35       --log-failed
36              View the log for any failed steps in a run or specific job
37
38
39       -t, --template <string>
40              Format JSON output using a Go template
41
42
43       -v, --verbose
44              Show job steps
45
46
47       -w, --web
48              Open run in the browser
49
50
51

OPTIONS INHERITED FROM PARENT COMMANDS

53       -R, --repo <[HOST/]OWNER/REPO>
54              Select another repository using the [HOST/]OWNER/REPO format
55
56
57

EXAMPLE

59              # Interactively select a run to view, optionally selecting a single job
60              $ gh run view
61
62              # View a specific run
63              $ gh run view 12345
64
65              # View a specific job within a run
66              $ gh run view --job 456789
67
68              # View the full log for a specific job
69              $ gh run view --log --job 456789
70
71              # Exit non-zero if a run failed
72              $ gh run view 0451 --exit-status && echo "run pending or passed"
73
74
75
76
77

SEE ALSO

79       gh-run(1)
80
81
82
83                                   Jun 2022                     GH-RUN-VIEW(1)