JIRA-EPIC-LIST(7)

🦋 jira-epic-list — Jira CLI(7) 🦋

🌸 NAME 🌸

bestie, jira-epic-list is the command for listing issues in a project. 💖

---

✨ SYNOPSIS ✨

jira epic list [EPIC-KEY] [flags]

---

💅 DESCRIPTION 💅

Okay so this one is simple and I mean that lovingly: it lists the top 100 epics. ✨

By default, epics are displayed in an explorer view. If that’s not the vibe, you can use the --table and --plain flags to display output in different modes. 🫶

---

🌈 OPTIONS 🌈

• -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.
• --history[=false] — issues you accessed recently.
• -w, --watching[=false] — 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. Created filter will have precedence over 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. Updated filter will have precedence over updated-after and updated-before filter.
• --created-after="" — filter by issues created after certain date.
• --updated-after="" — filter by issues updated after certain date.
• --created-before="" — filter by issues created before certain date.
• --updated-before="" — filter by issues updated before certain date.
• -q, --jql="" — run a raw JQL query in a given project context.
• --order-by="created" — 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; the format is literally format: : where is optional.
• --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.
• --table[=false] — display epics in table view.
• -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 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 🧪

# Display epics in an explorer view
$ jira epic list

# Display epics or epic issues in an interactive table view
$ jira epic list --table
$ jira epic list <KEY>

# Display epics or epic issues in a plain table view
$ jira epic list --table --plain
$ jira epic list <KEY> --plain

# Display epics or epic issues in a plain table view without headers
$ jira epic list --table --plain --no-headers
$ jira epic list <KEY> --plain --no-headers

# Display some columns of epic or epic issues in a plain table view
$ jira epic list --table --plain --columns key,summary,status
$ jira epic list <KEY> --plain --columns type,key,summary

---

🎀 SEE ALSO 🎀

• jira-epic(7) — go check that one out too, bestie 🫶

---

👑 HISTORY 👑

1-Jan-1980 Auto generated by spf13/cobra

---

mwah 💋 this whole page was Auto generated by spf13/cobra, dated Jan 1980, and lives under Jira CLI(7) — periodt, that’s the canon 🫶💅