use-jira

Essential Principles

Epic commands are separate from issue commands. jira epic create, jira epic add, jira epic remove, jira epic list — do NOT use jira issue create -tEpic or jira issue link for epic operations.
Stdin descriptions use --template - (not --body-template or --stdin). For issue edit, pipe to stdin with --no-input instead.
Use shorthand filter flags (-t, -s, -a, -y, -l, -P) for issue list instead of raw JQL when possible. Reserve -q/--jql for complex queries.
$(jira me) for current user. Use in -a$(jira me) for assignee, not currentUser() (that's JQL-only syntax).
Negate filters with ~ prefix. -s~Done means "not Done". Use -ax for unassigned.
Quote heredoc delimiters ('EOF') to prevent shell variable expansion in descriptions.
No interactive flags. Never use -i or interactive prompts — use --no-input to skip prompts.
--plain for scripting. Use --plain output when parsing results or piping to other commands.
Custom fields use field name, not ID. --custom field-name="value", not --custom customfield_10001="value". View available custom fields in jira init config output.

command -v jira >/dev/null 2>&1