GH-AGENT-TASK-LIST(1)

💅 gh-agent-task-list — ok so you wanna see your agent tasks bestie

Manual name is gh-agent-task-list, and this whole thing lives in the GitHub CLI manual ✨ It's a preview command, so like… it's cute but it's still in beta, iykyk 🫶

---

🌸 NAME 🌸

gh-agent-task-list — literally just lists your agent tasks 💖 (preview, meaning it's still cooking 🍓)

---

🦋 SYNOPSIS 🦋

gh agent-task list [flags]

That's it. That's the whole vibe. Flags are optional, slay ✨

---

🎀 OPTIONS 🎀

• -q, --jq <expression> — filters the JSON output using a jq expression. You got a fave jq one-liner? Use it here 💅
• --json <fields> — spits out JSON but only with the fields you picked. Choose your fighters wisely 👑
• -L, --limit <int> (default 30) — the max number of agent tasks to fetch. Default is 30, so if you want more you gotta ask nicely 🥺
• -t, --template <string> — formats the JSON output with a Go template. Run gh help formatting if you need the tea on formatting ☕
• -w, --web — opens your agent tasks in the browser instead of the terminal. Main character move fr fr 🌈

---

⭐ JSON FIELDS ⭐

These are the fields you can ask for with --json, and yes, I'm listing every single one because we don't skip 💖:

• completedAt
• createdAt
• id
• name
• pullRequestNumber
• pullRequestState
• pullRequestTitle
• pullRequestUrl
• repository
• state
• updatedAt
• user

Like… the full PR moment. pullRequestNumber, pullRequestState, pullRequestTitle, pullRequestUrl — the whole set, we love a thorough queen 🎀

---

🧚 EXIT CODES 🧚

Here's your vibe check after the command runs:

• 0: Successful execution — ate and left no crumbs 🔥
• 1: Error — 😭 it's giving chaos
• 2: Command canceled — nvm bestie, we bailed 🙈
• 4: Authentication required — you gotta log in first, no cap 🔑

⚠️ NOTE: specific commands may have additional exit codes. Refer to the command's help for more information — so like, always double-check, ok? 🫶

---

🌟 SEE ALSO 🌟

• gh-agent-task(1) — the parent situation, go check it out 💜

---

ok that's the whole page, mwah 💋 This was GitHub CLI version v2.102.0, dated Oct 2026 — periodt, go list some tasks bestie 💅✨