xbar plugin helper for Jira Issues

A package to help you list Jira issues from JQL queries in your menubar.

Usage

Create a xbar plugin which imports this package, configure it and then add as many group as you need:

timer.30s.js

#!/usr/bin/env /usr/local/bin/node

import Jira from '@studiometa/xbar-plugin-jira-issues';

const jira = new Jira({
  org: 'JIRA_ORG',
  username: 'JIRA_USERNAME',
  token: 'JIRA_TOKEN',
  accountId: 'JIRA_ACCOUNT_ID',
  tempoToken: 'TEMPO_TOKEN',
});

jira.addGroup('My tasks', {
  jql: `
    assignee = currentUser()
    AND resolution = Unresolved
    order by created DESC
  `,
});

jira.addGroup('Service Desk', {
  jql: `
    assignee = currentUser()
    AND project = "DESK"
    AND resolution = Unresolved
    order by updated DESC
  `,
});

(async () => {
  await jira.output();
})();

To configure the plugin, you will need the following information:

• You Jira username (JIRA_USERNAME), usually your email address
• Your Jira organization name, JIRA_ORG in https://JIRA_ORG.atlassian.net
• A Jira API token (JIRA_TOKEN), create one at https://id.atlassian.com/manage-profile/security/api-tokens
• Your Jira account ID (JIRA_ACCOUNT_ID), find it when accessing your profile in Jira: https://JIRA_ORG.atlassian.net/jira/people/JIRA_ACCOUNT_ID
• A Tempo API token (TEMPO_TOKEN), create one at https://JIRA_ORG.atlassian.net/plugins/servlet/ac/io.tempo.jira/tempo-app#!/configuration/api-integration