gh-workflow-list(1)

gh-workflow-list1

List workflows

Usage

gh workflow list [flags]

Overview

List workflow files, hiding disabled workflows by default.

Options

-a, --all

Include disabled workflows

-q, --jq <expression>

Filter JSON output using a jq expression

--json <fields>

Output JSON with the specified fields

-L, --limit <int> (default 50)

Maximum number of workflows to fetch

-t, --template <string>

Format JSON output using a Go template; see "gh help formatting"

Options inherited from parent commands

-R, --repo <[HOST/]OWNER/REPO>

Select another repository using the [HOST/]OWNER/REPO format

Aliases

gh workflow ls

Json fields

id, name, path, state

Exit status

0: Successful execution

1: Error

2: Command canceled

4: Authentication required

NOTE: Specific commands may have additional exit codes. Refer to the command's help for more information.

Releases

3 releases since Debian 12 (Bookworm); the text changed 2 times.

  1. 12
  2. 13
  3. Arch

--jq since Debian 13 (Trixie); --json since Debian 13 (Trixie); --template since Debian 13 (Trixie); -q since Debian 13 (Trixie); -t since Debian 13 (Trixie).

--limit until Debian 12 (Bookworm); -L until Debian 12 (Bookworm).

From github-cli 2.102.1-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.