set-milestone

name	set-milestone
description	Add, update, or remove milestones on GitHub issues using gh issue edit
disable-model-invocation	true

Set Issue Milestone

Add or update the milestone on a GitHub issue.

Your Task

Manage milestones on issues.

List Available Milestones

gh api repos/{owner}/{repo}/milestones --jq '.[] | "\(.number): \(.title) (\(.state))"'

Set Milestone on Issue

# Using gh issue edit (recommended)
gh issue edit {issue_number} --milestone "MVP"

Remove Milestone

gh issue edit {issue_number} --remove-milestone

Create New Milestone

gh api repos/{owner}/{repo}/milestones \
  -f title="v1.0" \
  -f description="First release milestone" \
  -f due_on="2026-06-01T00:00:00Z" \
  -f state="open"

Update Milestone

# Get milestone number first
gh api repos/{owner}/{repo}/milestones --jq '.[] | select(.title=="MVP") | .number'

# Update milestone
gh api repos/{owner}/{repo}/milestones/{milestone_number} \
  -X PATCH \
  -f description="Updated description" \
  -f state="open"

Close Milestone

gh api repos/{owner}/{repo}/milestones/{milestone_number} \
  -X PATCH \
  -f state="closed"

Bulk Set Milestone

# Set milestone on multiple issues
gh issue edit 1 2 3 4 5 --milestone "MVP"

Project Milestones

Current milestone is MVP; see github-conventions for the phase list.

Instructions

1. List available milestones if user is unsure
2. Use gh issue edit to set the milestone
3. Confirm the change was applied
4. For new milestones, use the API to create them first