---
name: "gh-gist-list"
section: "1"
platform: "linux"
package: "github-cli"
version: "2.102.1-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/gh-gist-list"
---

# gh-gist-list(1)

List your gists

## 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)](/gh-gist/1.md)**