Manpage logo

gh-gist-list - List your gists

NAME  SYNOPSIS  DESCRIPTION  OPTIONS  ALIASES  EXIT CODES  EXAMPLE  SEE ALSO 

NAME

gh-gist-list - List your gists

SYNOPSIS

gh gist list [flags]

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

--filter <expression>

Filter gists using a regular expression

--include-content

Include gists’ file content when filtering

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

Maximum number of gists to fetch

--public

Show only public gists

--secret

Show only secret gists

ALIASES

gh gist ls

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

# 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

gh-gist(1)


Updated 2026-06-01 - jenkler.se | uex.se