Skip to content

jira jql build

  • Usage: jira jql build [flags]

Compose a JQL string from jira-cli's shared filter flags. Use it to preview the query that issue list and related commands would run, or to build a query for another tool.

This command is local and does not contact Jira. Board scope is applied after the base query is built, and the returned URL is best-effort from the active profile's base URL.

Filters

--assignee <USER>

Restrict by assignee; use me for the current user

Allowed values:

  • me — current user
  • none — unassigned

--board <NAME>

Restrict to issues whose project belongs to the named board (case-insensitive exact match against the cache)

--board-id <ID>

Restrict to issues whose project belongs to the board with this id

Default: 0

--created <DATE>

Filter by created date (same grammar as --updated)

--epic <KEY>…

Restrict to issues in epic keys

--key <KEY>…

Restrict to issue key, comma list, or PROJ-1..PROJ-5 range

--label <NAME>…

Restrict by label

--priority <NAME>…

Restrict by priority

--project <KEY>…

Restrict to Jira project key

--reporter <USER>

Restrict by reporter; use me for the current user

Allowed values:

  • me — current user

--resolved <DATE>

Filter by resolved date (same grammar as --updated)

--status <NAME>…

Restrict by status: name, category comparator (<Done, >=In Progress), or negation (!Abandoned)

--type <NAME>…

Restrict by issue type

--updated <DATE>

Filter by updated date: -7d, 2026-01-01, >=2026-01-01, or A..B range

Sort

--desc

Sort descending

--order-by <FIELD>

Sort field

Allowed values:

  • updated — last-updated time (default)
  • created — creation time
  • priority — priority level
  • status — workflow status
  • key — issue key
  • summary — title text

Examples

jira jql build --project PROJ --status "In Progress"
jira jql build --assignee me --updated -7d --order-by updated # (1)!
jira jql build --key PROJ-1,PROJ-2 --label backend # (2)!
jira jql build --project PROJ --status Done --output=json # (3)!
  1. Build a query for your own recently updated issues
  2. Use a comma-separated issue-key filter
  3. Return the generated query and URL as JSON