GH-AGENT-TASK(1)

💅 gh-agent-task(1) — ur girl's guide to agent tasks

okay so bestie, welcome to the GitHub CLI manual page for gh-agent-task. this is the whole vibe, everything u need, no gatekeeping ✨

---

🌸 NAME 🌸

gh-agent-task — work with agent tasks (preview) 🫶

---

🎀 SYNOPSIS 🎀

gh agent-task <command> [flags]

---

🦋 DESCRIPTION 🦋

so working with agent tasks in the GitHub CLI is in preview and subject to change without notice. like, it's giving beta era, main character energy but still cooking 💀 so don't be surprised if stuff shifts under u.

---

✨ AVAILABLE COMMANDS ✨

• gh-agent-task-create(1) — create an agent task (preview) 💖
• gh-agent-task-list(1) — list agent tasks (preview) 📋
• gh-agent-task-view(1) — view an agent task session (preview) 👀

---

👑 ALIASES 👑

u can literally also call it:

• gh agent-tasks
• gh agent
• gh agents

iykyk, pick whichever one feels right in the moment 💅

---

🔥 EXIT CODES 🔥

• 0 — successful execution, we ate and left no crumbs ✨
• 1 — error 😭
• 2 — command canceled, not me hitting Ctrl+C 🙈
• 4 — authentication required 🔐

NOTE: specific commands may have additional exit codes. refer to the command's help for more information, bestie, don't come for me 💀

---

⭐ EXAMPLE ⭐

# List your most recent agent tasks
$ gh agent-task list

# Create a new agent task on the current repository
$ gh agent-task create "Improve the performance of the data processing pipeline"

# View details about agent tasks associated with a pull request
$ gh agent-task view 123

# View details about a specific agent task
$ gh agent-task view 12345abc-12345-12345-12345-12345abc

---

🌈 SEE ALSO 🌈

• gh(1)

---

and that's the whole page, bestie 🧚 this little gem comes to u from GitHub CLI v2.102.0, dated Oct 2026 — go forth and agent-task responsibly 💜🫶