GH-GIST-LIST(1) GitHub CLI manual GH-GIST-LIST(1)

# [NAME](#NAME)

gh-gist-list - List your gists

# [SYNOPSIS](#SYNOPSIS)

**gh gist list \[flags]**

# [DESCRIPTION](#DESCRIPTION)

List gists from your user account.

You can use a regular expression to filter the description, file names, or even the content of files in the gist using **--filter**.

For supported regular expression syntax, see ⟨https://pkg.go.dev/regexp/syntax⟩.

Use **--include-content** to include content of files, noting that this will be slower and increase the rate limit used. Instead of printing a table, code will be printed with highlights similar to **gh search code**:

```
{{gist ID}} {{file name}}


    {{description}}


        {{matching lines from content}}
```

No highlights or other color is printed when output is redirected.

# [OPTIONS](#OPTIONS)

[**--filter** **<expression>**](#filter)

Filter gists using a regular expression

[**--include-content**](#include_content)

Include gists' file content when filtering

[**-L**, **--limit** **<int> (default 10)**](#L)

Maximum number of gists to fetch

[**--public**](#public)

Show only public gists

[**--secret**](#secret)

Show only secret gists

# [ALIASES](#ALIASES)

gh gist ls

# [EXIT CODES](#EXIT_CODES)

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.

# [EXAMPLE](#EXAMPLE)

```
# List all secret gists from your user account
$ gh gist list --secret
# Find all gists from your user account mentioning "octo" anywhere
$ gh gist list --filter octo --include-content
```

# [SEE ALSO](#SEE_ALSO)

[**gh-gist(1)**](/man/os/gh/gh-gist.1)

Oct 2026

---

Document: gh-gist-list(1) from gh 2.102.0-r1 (Chainguard OS)
Source: https://github.com/cli/cli