name: gh-viewing-issue-details description: Retrieves detailed information about a specific GitHub issue. Use when you need to read the body, comments, or labels of an issue.
Viewing Issue Details
Purpose
Provides full context for a single GitHub issue using the gh issue view command.
1. Safety & Verification
- Issue Number: Requires a valid issue number or URL.
- JSON Fields: Use
--jsonto specify which fields to retrieve.
2. Common Workflows
Workflow: Get Full Issue Context
Retrieves title, body, and comments.
Command:
gh issue view <issue-number> --comments --json number,title,body,comments,labels,state
Workflow: Read Latest Comment
Useful for tracking recent activity.
Command:
gh issue view <issue-number> --json comments --jq '.comments[-1].body'
Workflow: Check Hierarchical Context (Sub-issues)
Identifies if an issue is a sub-issue or has sub-issues of its own.
Command:
# 1. Check if the issue has a parent
gh api /repos/{owner}/{repo}/issues/{issue_number}/parent
# 2. List all sub-issues (children)
gh api /repos/{owner}/{repo}/issues/{issue_number}/sub_issues
3. Output Handling
The output is optimized for agent consumption via JSON.