GH-AGENT-TASK-VIEW(1)

👑 gh-agent-task-view(1) — the GitHub CLI manual, bestie edition 💅

okay so real talk: this is a page straight out of the GitHub CLI manual (yes, that GitHub CLI, the one you already have open in another tab), and it's about peeking at an agent task session. preview era ✨

---

✨ NAME ✨

gh-agent-task-view — view an agent task session (preview) 🫶

🦋 SYNOPSIS 🦋

gh agent-task view [<session-id> | <pr-number> | <pr-url> | <pr-branch>]
[flags]

like, you give it something that points at a session — or honestly nothing at all, the brackets said optional — and then flags on top. iconic behavior.

🌸 DESCRIPTION 🌸

View an agent task session. that's it, that's the whole vibe. you look at the session, you see the session, you move on with your life 💖

💅 OPTIONS 💅

• --follow — follow the agent session logs, so you're just sitting there watching them scroll by like a livestream 🍓
• -q, --jq <expression> — filter the JSON output using a jq expression, because raw JSON is giving a lot and sometimes you just want the one field, iykyk
• --json <fields> — output JSON with the specified fields (the field names are down in JSON FIELDS, keep scrolling bestie)
• --log — show the agent session logs, one and done, no following required 📜
• -R, --repo <[HOST/]OWNER/REPO> — select another repository using the [HOST/]OWNER/REPO format. note the [HOST/] part is optional, so it's either OWNER/REPO or HOST/OWNER/REPO 🎀
• -t, --template <string> — format the JSON output using a Go template; see gh help formatting for the lore 📖
• -w, --web — open the agent task in the browser. mouse girlies rise 👑

🔥 JSON FIELDS 🔥

these are the exact field names, no cap, copy them character for character:

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

that's twelve fields and we are obsessed with all twelve 😌

⭐ 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 — like, actually refer to it, don't guess 💀

🌈 EXAMPLE 🌈

# View an agent task by session ID
$ gh agent-task view e2fa49d2-f164-4a56-ab99-498090b8fcdf

# View an agent task by pull request number in current repo
$ gh agent-task view 12345

# View an agent task by pull request number
$ gh agent-task view --repo OWNER/REPO 12345

# View an agent task by pull request reference
$ gh agent-task view OWNER/REPO#12345

# View a pull request agents tasks in the browser
$ gh agent-task view 12345 --web

see how it takes a raw session id, a PR number, a full OWNER/REPO#12345 reference, and then just yeets itself into the browser with --web? versatile queen 💜

🧚 SEE ALSO 🧚

• gh-agent-task(1) — the parent command, go say hi 💖

---

later bestie 🌸 this was GitHub CLI v2.102.0, dated Oct 2026 — mwah 💋