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       -a, --attempt <uint>
17              The attempt number of the workflow run
18
19
20       --exit-status
21              Exit with non-zero status if run failed
22
23
24       -j, --job <string>
25              View a specific job ID from a run
26
27
28       -q, --jq <expression>
29              Filter JSON output using a jq expression
30
31
32       --json <fields>
33              Output JSON with the specified fields
34
35
36       --log  View full log for either a run or specific job
37
38
39       --log-failed
40              View the log for any failed steps in a run or specific job
41
42
43       -t, --template <string>
44              Format JSON output using a Go template; see "gh help formatting"
45
46
47       -v, --verbose
48              Show job steps
49
50
51       -w, --web
52              Open run in the browser
53
54
55

OPTIONS INHERITED FROM PARENT COMMANDS

57       -R, --repo <[HOST/]OWNER/REPO>
58              Select another repository using the [HOST/]OWNER/REPO format
59
60
61

EXAMPLE

63              # Interactively select a run to view, optionally selecting a single job
64              $ gh run view
65
66              # View a specific run
67              $ gh run view 12345
68
69              # View a specific run with specific attempt number
70              $ gh run view 12345 --attempt 3
71
72              # View a specific job within a run
73              $ gh run view --job 456789
74
75              # View the full log for a specific job
76              $ gh run view --log --job 456789
77
78              # Exit non-zero if a run failed
79              $ gh run view 0451 --exit-status && echo "run pending or passed"
80
81
82
83
84

SEE ALSO

86       gh-run(1)
87
88
89
90                                   Oct 2023                     GH-RUN-VIEW(1)