Skip to content

Jira

Displays all Jira issues assigned to you for the specified project.

Configuration

Single Jira Project

jira:
  apiKey: "p0d13*********************************************c3"
  colors:
    rows:
      even: "lightblue"
      odd: "white"
  domain: "https://umbrellacorp.atlassian.net"
  email: "chriscummer@me.com"
  enabled: true
  jql: "issueType = Story"
  position:
    top: 4
    left: 1
    height: 1
    width: 2
  project: "ProjectA"
  refreshInterval: 15m
  username: "chris.cummer"
  verifyServerCertificate: true

Multiple Jira Projects

If you want to monitor multiple Jira projects, use the following configuration (note the difference in project):

jira:
  apiKey: "p0d13*********************************************c3"
  colors:
    rows:
      even: "lightblue"
      odd: "white"
  domain: "https://umbrellacorp.atlassian.net"
  email: "chriscummer@me.com"
  enabled: true
  jql: "issueType = Story"
  position:
    top: 4
    left: 1
    height: 1
    width: 2
  project: ["ProjectA", "ProjectB"]
  refreshInterval: 15m
  username: "chris.cummer"
  verifyServerCertificate: true

Screenshots

jira screenshot

Attributes

Name Value
apiKey
Your Jira API key. Leave this blank to use the WTF_JIRA_API_KEY environment variable.
colors.rows.even
The foreground color for even-numbered rows.
Any X11 color name.
colors.rows.odd
The foreground color for odd-numbered rows.
Any X11 color name.
domain
Your Jira corporate domain.
A valid URI.
email
The email address associated with your Jira account.
A valid email address.
jql
Optional Custom JQL to be appended to the search query.
See Search Jira Like a Boss with JQL for details.
project
An array of projects to get data from
username
Your Jira username. {{ undesc }}
verifyServerCertificate
Whether or not to verify the server's certificate chain and hostname. Default: false.
true, false

Keyboard

Key Action
/ Open/close the widget's help modal

Source Code

https://github.com/wtfutil/wtf/tree/master/modules/jira