hub-issue(1)

🦋 NAME 🦋

okay so bestie, this is hub-issue(1) from the hub manual — the command that manages GitHub Issues for the current repository. it’s giving issue-organization main character energy, and ngl? iconic. 💅✨

---

✨ SYNOPSIS ✨

hub issue [-a ASSIGNEE] [-c CREATOR] [-@ USER] [-s STATE] [-f FORMAT]
[-M MILESTONE] [-l LABELS] [-d DATE] [-o SORT_KEY [-^]] [-L LIMIT]
hub issue show [-f FORMAT] NUMBER
hub issue create [-oc] [-m MESSAGE|-F FILE] [--edit] [-a USERS] [-M
MILESTONE] [-l LABELS]
hub issue update NUMBER [-m MESSAGE|-F FILE] [--edit] [-a USERS] [-M
MILESTONE] [-l LABELS] [-s STATE]
hub issue labels [--color]
hub issue transfer NUMBER REPO

🎀 COMMANDS 🎀

With no arguments, show a list of open issues. that’s the default vibe check 👑

show

Show an existing issue specified by NUMBER. peek at your fave issue, no cap. 🦋

create

Open an issue in the current repository. new issue era unlocked ✨

update

Update fields of an existing issue specified by NUMBER. Use --edit to edit the title and message interactively in the text editor. glow-up time 💅

labels

List the labels available in this repository. label inventory realness 🎀

transfer

Transfer an issue to another repository. moving day, but make it GitHub 🦋

💖 OPTIONS 💖

• -a, --assignee ASSIGNEE — In list mode, display only issues assigned to ASSIGNEE. filter by assignee, slay ✨
• -a, --assign USERS — A comma-separated list of GitHub handles to assign to the created issue. same flag letter, different mode — context is everything iykyk 💅
• -c, --creator CREATOR — Display only issues created by CREATOR. creator filter, got it 💚
• -@, --mentioned USER — Display only issues mentioning USER. mention radar: on 🌈
• -s, --state STATE — Display issues with state STATE (default: "open"). state check 🍓
• -f, --format FORMAT — Pretty print the contents of the issues using format FORMAT (default: "%sC%>(8)%i%Creset %t% l%n"). See the "PRETTY FORMATS" section of git-log(1) for some additional details on how placeholders are used in format. The available placeholders for issues are:
  • %I: issue number
  • %i: issue number prefixed with "#"
  • %U: the URL of this issue
  • %S: state (i.e. "open", "closed")
  • %sC: set color to red or green, depending on issue state.
  • %t: title
  • %l: colored labels
  • %L: raw, comma-separated labels
  • %b: body
  • %au: login name of author
  • %as: comma-separated list of assignees
  • %Mn: milestone number
  • %Mt: milestone title
  • %NC: number of comments
  • %Nc: number of comments wrapped in parentheses, or blank string if zero.
  • %cD: created date-only (no time of day)
  • %cr: created date, relative
  • %ct: created date, UNIX timestamp
  • %cI: created date, ISO 8601 format
  • %uD: updated date-only (no time of day)
  • %ur: updated date, relative
  • %ut: updated date, UNIX timestamp
  • %uI: updated date, ISO 8601 format
  • %n: newline
  • %%: a literal %
• --color[=WHEN] — Enable colored output even if stdout is not a terminal. WHEN can be one of "always" (default for --color), "never", or "auto" (default). rainbow terminal moment 🌈
• -m, --message MESSAGE — The text up to the first blank line in MESSAGE is treated as the issue title, and the rest is used as issue description in Markdown format. When multiple --message are passed, their values are concatenated with a blank line in-between. When neither --message nor --file were supplied to issue create, a text editor will open to author the title and description in. message magic 💖
• -F, --file FILE — Read the issue title and description from FILE. Pass "-" to read from standard input instead. See --message for the formatting rules. file fuel 🎀
• -e, --edit — Open the issue title and description in a text editor before submitting. This can be used in combination with --message or --file. edit era 💅
• -o, --browse — Open the new issue in a web browser. browser reveal 🦋
• -c, --copy — Put the URL of the new issue to clipboard instead of printing it. clipboard copy, no cap 💜
• -M, --milestone NAME — Display only issues for a GitHub milestone with the name NAME. When opening an issue, add this issue to a GitHub milestone with the name NAME. 🚨 Passing the milestone number is deprecated. yes, deprecated — noted, bestie. 💀
• -l, --labels LABELS — Display only issues with certain labels. When opening an issue, add a comma-separated list of labels to this issue. label moment 🎀
• -d, --since DATE — Display only issues updated on or after DATE in ISO 8601 format. date filter 🍓
• -o, --sort KEY — Sort displayed issues by "created" (default), "updated" or "comments". sorting supremacy 🔥
• -^, --sort-ascending — Sort by ascending dates instead of descending. ascending agenda ⬆️
• -L, --limit LIMIT — Display only the first LIMIT issues. limit the scroll ✨
• --include-pulls — Include pull requests as well as issues. pulls in the mix too 💅
• --color — Enable colored output for labels list. labels but make it colorful 🌈

🌈 SEE ALSO 🌈

hub-pr(1), hub(1)

---

💖 later bestie — this page was hub version 2.14.2, dated 07 Jan 2024. stay iconic 💖