GH-SECRET-LIST(1)

💖 GH-SECRET-LIST(1) 💖

okay so bestie, this is the gh-secret-list page from the GitHub CLI manual — yes, the real official one, and yes I'm about to make it make sense 🫶

✨ NAME ✨

gh-secret-list — literally just list secrets, that's the whole gig 💅

🎀 SYNOPSIS 🎀

gh secret list [flags]

🌸 DESCRIPTION 🌸

so you wanna see your secrets? iconic. here's the thing though — secrets live at different levels, and you gotta know which level you're looking at, no cap:

• repository (this is the default, bestie 🔥): available to GitHub Actions runs, Agents sessions, or Dependabot in a repository
• environment: available to GitHub Actions runs for a deployment environment in a repository
• organization: available to GitHub Actions runs, Agents sessions, Dependabot, or Codespaces within an organization
• user: available to Codespaces for your user

pick your level, pick your vibe, go off 🦋

---

🌈 OPTIONS 🌈

• -a, --app <string> — list secrets for one specific application. your choices are {actions|agents|codespaces|dependabot}, choose wisely 💀
• -e, --env <string> — list secrets for an environment
• -q, --jq <expression> — filter the JSON output using a jq expression. yes queen, pipe it through jq, slay ✨
• --json <fields> — output JSON with the specified fields (the full field list is down below, keep scrolling 👀)
• -o, --org <string> — list secrets for an organization
• -t, --template <string> — format the JSON output using a Go template; see gh help formatting for the deets 📖
• -u, --user — list a secret for your user (just yours, main character energy 👑)

💫 OPTIONS INHERITED FROM PARENT COMMANDS 💫

• -R, --repo [HOST/]OWNER/REPO — select another repository using the [HOST/]OWNER/REPO format. note the optional host up front, iykyk 🧚

---

🦋 ALIASES 🦋

gh secret ls

that's it. ls is the short king. use it, love it 💜

💖 JSON FIELDS 💖

name, numSelectedRepos, selectedReposURL, updatedAt, visibility

these are the exact field names for --json, character for character, don't @ me 😭

⭐ EXIT CODES ⭐

• 0: successful execution — we ate, no crumbs 🍓
• 1: error — it's giving oops 🙈
• 2: command canceled — you hit Ctrl+C and it respected that
• 4: authentication required — go log in bestie, fr fr 🔑

NOTE: specific commands may have additional exit codes. refer to the command's help for more information 💀

🔥 SEE ALSO 🔥

• gh-secret(1) — the parent page, the origin story

---

okay that's the whole page, you're welcome 😌 this was GitHub CLI v2.102.0, dated Oct 2026 — the drama of that date is not lost on me, anyway ily, bye 💅✨🌈