Skip to content
2 min read

fj milestone

Work with milestones

fj milestone [OPTIONS] <COMMAND>

Every command also accepts the global flags: --host, --debug, --no-pager, --json-fields.

fj milestone list

List milestones in a repo

fj milestone list [OPTIONS]

Options

  • -R, --repo <REPO> — Target repository as <owner>/<name>. Inferred from the git remote when omitted
  • -s, --state <STATE> — Filter by state [default: open]
  • --json — Emit JSON instead of a table

fj milestone view

View a milestone by id

fj milestone view [OPTIONS] <ID>

Arguments

  • <ID> — Milestone id

Options

  • -R, --repo <REPO> — Target repository as <owner>/<name>. Inferred from the git remote when omitted
  • --json — Emit JSON instead of a table

fj milestone create

Create a milestone

fj milestone create [OPTIONS] <TITLE>

Arguments

  • <TITLE> — Milestone title

Options

  • -R, --repo <REPO> — Target repository as <owner>/<name>. Inferred from the git remote when omitted
  • -b, --body <BODY> — Description (use - for stdin, omit to open $EDITOR)
  • --due-on <DUE_ON> — Due date in ISO-8601 (e.g. 2026-06-01T00:00:00Z)

fj milestone edit

Edit a milestone

fj milestone edit [OPTIONS] <ID>

Arguments

  • <ID> — Milestone id

Options

  • -R, --repo <REPO> — Target repository as <owner>/<name>. Inferred from the git remote when omitted
  • -t, --title <TITLE> — Milestone title
  • -b, --body <BODY> — Description (use - for stdin, omit to open $EDITOR)
  • --due-on <DUE_ON> — Due date (YYYY-MM-DD)
  • --body-editor — Edit the description in $EDITOR

fj milestone close

Close a milestone

fj milestone close [OPTIONS] <ID>

Arguments

  • <ID> — Milestone id

Options

  • -R, --repo <REPO> — Target repository as <owner>/<name>. Inferred from the git remote when omitted
  • --json — Emit JSON instead of a table

fj milestone reopen

Reopen a closed milestone

fj milestone reopen [OPTIONS] <ID>

Arguments

  • <ID> — Milestone id

Options

  • -R, --repo <REPO> — Target repository as <owner>/<name>. Inferred from the git remote when omitted
  • --json — Emit JSON instead of a table

fj milestone delete

Delete a milestone

fj milestone delete [OPTIONS] <ID>

Arguments

  • <ID> — Milestone id

Options

  • -R, --repo <REPO> — Target repository as <owner>/<name>. Inferred from the git remote when omitted
  • -y, --yes — Skip the confirmation prompt

fj milestone assign

Assign an issue or PR to a milestone (or detach with –milestone none)

fj milestone assign [OPTIONS] --milestone <MILESTONE> <ISSUE>

Arguments

  • <ISSUE> — Issue or PR number

Options

  • -R, --repo <REPO> — Target repository as <owner>/<name>. Inferred from the git remote when omitted
  • --milestone <MILESTONE> — Milestone id, or none to detach
Contributors
  • Stephen Way