gh-milestone

README

gh milestone

A gh extension for managing Github Milestones

Installation

gh extension install valeriobelli/gh-milestone

Usage

By default, this extension uses the GitHub's Access Token of the current user for the host github.com.

You override the authentication of the current registered gh user by defining GITHUB_TOKEN in your environment variables. You can also override the host where your user is authenticated by setting GITHUB_MILESTONE_HOST still in your environment variables. By defining this latter, you change the behaviour of gh config get --host <host> oauth_token, which is the command this extension relies upon.

Create a new milestone

# Interactive mode
gh milestone create

# Flags mode
gh milestone create --title v1.0.0 --description "This is a description" --due-date 2022-06-01

List milestones

# Extended command
gh milestone list

# Alias
gh milestone ls

Edit a milestone

gh milestone edit <milestone number> --title "New title"

View a milestone

gh milestone view <milestone number>

Delete milestone

# Interactive mode
gh milestone delete <milestone number>

# Automatic
gh milestone delete <milestone number> --confirm