gh-issue-close

name	gh-issue-close
description	Close GitHub issues with gh CLI, choosing completed vs not planned and optionally adding a closing comment.
allowed-tools	Bash, Read, Grep
handoffs	[{"label":"View Issue","agent":"gh-issue-view","prompt":"View this closed issue","send":true},{"label":"Reopen Issue","agent":"gh-issue-edit","prompt":"Reopen this issue","send":true}]

GitHub Issue Close

When to use

• The user asks to close or resolve an issue.
• Work is finished, or the issue is duplicate/invalid/out of scope.

Inputs to confirm

• Issue number or URL.
• Target repo if not the current repo (--repo OWNER/REPO).
• Close reason: completed or not planned.
• Optional closing comment text.

Workflow

1. Verify auth and access:

   gh --version
   gh auth status
   

2. Check current state:

   gh issue view 123 --json number,title,state,stateReason
   

3. Close with the right reason and optional comment:

   gh issue close 123 --reason "completed"
   gh issue close 123 --reason "not planned" --comment "Duplicate of #45"
   

4. Verify closure:

   gh issue view 123 --json state,stateReason,closedAt --jq '"\(.state) \(.stateReason) \(.closedAt)"'
   

Examples

# Close as completed
~ gh issue close 123 --reason "completed"

# Close as not planned with a reason
~ gh issue close 123 --reason "not planned" --comment "Out of scope for current roadmap."

Notes

• Arguments accept number or URL (gh issue close --help).
• Close reasons are exactly completed or not planned.

References

• GitHub CLI manual: https://cli.github.com/manual/
• gh issue close --help