JIRA-ISSUE-LIST(7)

📦 version 1.7.0, in nixos 26.05, nixpkgs unstable

💖 JIRA-ISSUE-LIST(7) 💖

okay bestie, welcome to jira-issue-list from the Jira CLI manual, section 7 — this is the one that lists issues in a project, and honestly it ate 💅

✨ NAME ✨

jira-issue-list — List lists issues in a project 🫶

(yes the original says "List lists", that's not a typo I made, that's canon, we respect it)

🎀 SYNOPSIS 🎀

jira issue list [optional text to query] [flags]

🌸 DESCRIPTION 🌸

So like — this lists issues in a given project. That's the whole vibe. ✨

The fun part? You can stack different flags together to cook up one unique query. For instance, say you want the issues that are high priority, currently in progress, were created this month, and have the given labels:

$ jira issue list -yHigh -s"In Progress" --created month -lbackend -l"high prio"

You can also drop an optional search query in as a positional argument, and it does the exact same thing as typing a search query into the Jira UI's search box. literally the same energy 🔥

Issues show up in an interactive list view by default. But if you're a plain-text girly, there's the --plain flag for plain text mode. Then --no-headers hides the table headers in plain view, and --no-truncate shows off all the available fields in plain mode. 🦋

💅 OPTIONS 💅

  • -t, --type="" — filter issues by type
  • -R, --resolution="" — filter issues by resolution type
  • -s, --status=[] — filter issues by status
  • -y, --priority="" — filter issues by priority
  • -r, --reporter="" — filter issues by reporter (email or display name)
  • -a, --assignee="" — filter issues by assignee (email or display name)
  • -C, --component="" — filter issues by component
  • -l, --label=[] — filter issues by label
  • -P, --parent="" — filter issues by parent
  • --history[=false] — the issues you accessed recently 👀
  • -w, --watching[=false] — the issues you are watching 👑
  • --created="" — filter issues by created date. Accepts: today, week, month, year, or a date in yyyy-mm-dd and yyyy/mm/dd format, or a period format using w = weeks, d = days, h = hours, m = minutes. eg: -10d. Heads up: the created filter will have precedence over the created-after and created-before filter ⭐
  • --updated="" — filter issues by updated date. Accepts: today, week, month, year, or a date in yyyy-mm-dd and yyyy/mm/dd format, or a period format using w = weeks, d = days, h = hours, m = minutes. eg: -10d. Also a precedence situation: the updated filter will have precedence over the updated-after and updated-before filter ⭐
  • --created-after="" — filter by issues created after a certain date
  • --updated-after="" — filter by issues updated after a certain date
  • --created-before="" — filter by issues created before a certain date
  • --updated-before="" — filter by issues updated before a certain date
  • -q, --jql="" — run a raw JQL query in a given project context 🔥
  • --order-by="created" — the field to order the list with
  • --reverse[=false] — reverse the display order (default "DESC")
  • --paginate="0:100" — paginate the result. Max 100 at a time, format: : where is optional 😭 (that's genuinely how it's printed in the manual, the placeholder got eaten, don't come for me)
  • --plain[=false] — display output in plain mode
  • --no-headers[=false] — don't display table headers in plain mode. Works only with --plain
  • --no-truncate[=false] — show all available columns in plain mode. Works only with --plain
  • --delimiter="\t" — custom delimeter for columns in plain mode. Works only with --plain
  • --comments=1 — show N comments when viewing the issue
  • --raw[=false] — print raw JSON output
  • --csv[=false] — print output in CSV format
  • --columns="" — comma separated list of columns to display in the plain mode. Accepts: TYPE, KEY, SUMMARY, STATUS, ASSIGNEE, REPORTER, PRIORITY, RESOLUTION, CREATED, UPDATED, LABELS
  • --fixed-columns=1 — number of fixed columns in the interactive mode
  • -h, --help[=false] — help for list 🫶

🌈 OPTIONS INHERITED FROM PARENT COMMANDS 🌈

  • -c, --config="" — config file (default is /homeless-shelter/.config/.jira/.config.yml, can be overridden with the JIRA_CONFIG_FILE env var)
  • --debug[=false] — turn on debug output 🐛
  • -p, --project="" — Jira project to look into (defaults to /homeless-shelter/.config/.jira/.config.yml)

🍓 EXAMPLE 🍓

these are copy-paste ready, no cap
$ jira issue list
# Limit list to 20 items
$ jira issue list --paginate 20
# Get 50 items starting from 10
$ jira issue list --paginate 10:50
# Search for issues containing specific text
$ jira issue list "Feature Request"
# List issues in a plain table view without headers
$ jira issue list --plain --no-headers
# List some columns of the issue in a plain table view
$ jira issue list --plain --columns key,assignee,status
# List issues in a plain table view and show all fields
$ jira issue list --plain --no-truncate
# List issues in a plain table view using custom delimiter (default is "\t")
$ jira issue list --plain --delimeter "|"

(yes, --delimeter — that's exactly how the example spells it, I'm not touching it 🙈)

# List issues as raw JSON data
$ jira issue list --raw
# List issues of type "Epic" in status "Done"
$ jira issue list -tEpic -sDone
# List issues in status other than "Open" and is assigned to no one
$ jira issue list -s~Open -ax
# List issues from all projects
$ jira issue list -q"project IS NOT EMPTY"

🧚 SEE ALSO 🧚

💜 HISTORY 💜

  • 1-Jan-1980 — Auto generated by spf13/cobra

and that's the whole thing, bestie ✨ this page was auto generated by spf13/cobra, dated Jan 1980, and it lives in the Jira CLI(7) manual — mwah, go list some issues 💋🎀

📦 where this page comes from