Skip to content

πŸ“ Small CLI tool to set JIRA Story Points and Priority

License

GPL-3.0, Unknown licenses found

Licenses found

GPL-3.0
LICENSE
Unknown
LICENSE-BUNDLED
Notifications You must be signed in to change notification settings

redhat-plumbers-in-action/storypointer

Repository files navigation

JIRA StoryPointer

npm version Tests Linters CodeQL codecov

Description

Simple CLI tool that provides an interactive interface to quickly set priority and story points for your JIRA issues. No need to open the JIRA web interface.

Usage

Make sure to store your JIRA Personal Access Token (PAT) in the ~/.config/storypointer/.env or ~/.env.storypointer file:

# ~/.config/storypointer/.env
JIRA_API_TOKEN="exaple-token"

Tip

You can also set default values for the assignee, developer, and component fields in the ~/.config/storypointer/.env or ~/.env.storypointer file:

# ~/.config/storypointer/.env
ASSIGNEE="your-jira-username"
DEVELOPER="your-jira-username"
COMPONENT="your-component"

Using Node.js

# run it using npx
npx storypointer

# or install it globally using npm
npm install -g storypointer
storypointer

Using Fedora

Important

The Fedora package is not available yet.

How to use

Important

This tool is intended to be used by Red Hat employees on the Red Hat JIRA instance. It may be adapted to work with other JIRA instances in the future.

$ storypointer --help
Usage: storypointer [options] [string]

πŸ“ Small CLI tool to set JIRA Story Points and Priority

Arguments:
  string                       Issue keys separated by `␣`

Options:
  -V, --version                output the version number
  -c, --component [component]  Issue component
  -a, --assignee [assignee]    Issue assignee (default: "<user-login>@redhat.com")
  -d, --developer [developer]  Issue developer
  -l, --legend                 Print legend
  -h, --help                   display help for command

Note

Only 50 issues are fetched from JIRA at a time. If you want to triage more than 50 issues just run the command again.

Tip

You can disable default values by setting NODEFAULTS environment variable to true:

NODEFAULTS=true npx storypointer

Examples

Size all issues of the curl component:

storypointer -c curl

JIRA Version: 9.12.10
JQL: project = RHEL AND ("Story Points" is EMPTY OR priority is EMPTY) AND status != Closed AND component = curl ORDER BY id DESC
5 issues are waiting to be sized and prioritized.

πŸ› RHEL-1234 - In Progress - Assignee
Add new feature to curl
See more: https://issues.redhat.com/browse/RHEL-1234

? Story Points
  1
  2
❯ 3
  5
  8
  13
 ---
  SKIP
  EXIT

You can use the arrow keys to select the story points and press Enter to confirm. Then you can select the priority. You can exit the tool by pressing Ctrl C or selecting the Exit option.