{"id":22128617,"url":"https://github.com/redhat-plumbers-in-action/storypointer","last_synced_at":"2026-02-24T21:32:46.830Z","repository":{"id":252750486,"uuid":"840225151","full_name":"redhat-plumbers-in-action/storypointer","owner":"redhat-plumbers-in-action","description":"📐 Small CLI tool to set JIRA Story Points, Priority and Severity","archived":false,"fork":false,"pushed_at":"2024-11-25T13:37:57.000Z","size":2109,"stargazers_count":4,"open_issues_count":2,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-11-25T14:26:28.983Z","etag":null,"topics":["cli","jira","priority","severity","sizing","story-points"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/redhat-plumbers-in-action.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-08-09T08:33:25.000Z","updated_at":"2024-11-25T13:36:49.000Z","dependencies_parsed_at":"2024-11-15T13:27:50.368Z","dependency_job_id":"7d59ff47-62ea-4e31-8ce1-6cf2bfc8f6b1","html_url":"https://github.com/redhat-plumbers-in-action/storypointer","commit_stats":null,"previous_names":["redhat-plumbers-in-action/storypointer"],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/redhat-plumbers-in-action%2Fstorypointer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/redhat-plumbers-in-action%2Fstorypointer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/redhat-plumbers-in-action%2Fstorypointer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/redhat-plumbers-in-action%2Fstorypointer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/redhat-plumbers-in-action","download_url":"https://codeload.github.com/redhat-plumbers-in-action/storypointer/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":227606222,"owners_count":17792786,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","jira","priority","severity","sizing","story-points"],"created_at":"2024-12-01T17:46:17.963Z","updated_at":"2026-02-24T21:32:46.825Z","avatar_url":"https://github.com/redhat-plumbers-in-action.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# JIRA StoryPointer\n\n[![npm version][npm-status]][npm] [![Tests][test-status]][test] [![Linters][lint-status]][lint] [![CodeQL][codeql-status]][codeql] [![codecov][codecov-status]][codecov]\n\n[npm]: https://www.npmjs.com/package/storypointer\n[npm-status]: https://img.shields.io/npm/v/storypointer\n\n[test]: https://github.com/redhat-plumbers-in-action/storypointer/actions/workflows/tests.yml\n[test-status]: https://github.com/redhat-plumbers-in-action/storypointer/actions/workflows/tests.yml/badge.svg\n\n[lint]: https://github.com/redhat-plumbers-in-action/storypointer/actions/workflows/lint.yml\n[lint-status]: https://github.com/redhat-plumbers-in-action/storypointer/actions/workflows/lint.yml/badge.svg\n\n[codeql]: https://github.com/redhat-plumbers-in-action/storypointer/actions/workflows/codeql-analysis.yml\n[codeql-status]: https://github.com/redhat-plumbers-in-action/storypointer/actions/workflows/codeql-analysis.yml/badge.svg\n\n[codecov]: https://codecov.io/gh/redhat-plumbers-in-action/storypointer\n[codecov-status]: https://codecov.io/gh/redhat-plumbers-in-action/storypointer/graph/badge.svg?token=79yXVIeHyn\n\n\u003c!-- --\u003e\n\n## Description\n\nSimple CLI tool that provides an interactive interface to quickly set priority, severity and story points for your JIRA issues. No need to open the JIRA web interface.\n\nStoryPointer uses base JQL query to fetch issues that are not closed and have no story points or priority set - `Project in (RHEL, \"RHEL Miscellaneous\", Fedora) AND (type in (Story, Task) AND (\"Story Points\" is EMPTY OR priority is EMPTY) OR type not in (Story, Task) AND (\"Story Points\" is EMPTY OR priority is EMPTY OR Severity is EMPTY)) AND status != Closed`. The query can be customized using the CLI command options or by setting ENV variables.\n\n## Usage\n\nMake sure to store your JIRA Personal Access Token (PAT) in the `~/.config/storypointer/.env` or `~/.env.storypointer` file:\n\n```bash\n# ~/.config/storypointer/.env\nJIRA_API_TOKEN=\"exaple-token\"\n```\n\n\u003e [!TIP]\n\u003e\n\u003e You can also set default values for the `assignee`, `developer`, `component` and more in the `~/.config/storypointer/.env` or `~/.env.storypointer` file:\n\u003e\n\u003e ```bash\n\u003e # ~/.config/storypointer/.env\n\u003e ASSIGNEE=\"your-jira-username\"\n\u003e DEVELOPER=\"your-jira-username\"\n\u003e TEAM=\"your-jira-team\"\n\u003e COMPONENT=\"your-component\"\n\u003e JQL=\"your-jql-query\"\n\u003e ```\n\n### Using Node.js\n\n```bash\n# run it using npx\nnpx storypointer\n\n# or install it globally using npm\nnpm install -g storypointer\nstorypointer\n```\n\n### Using RHEL Developer Toolbox\n\nStoryPointer is available as a module in [RHEL Developer Toolbox](https://gitlab.com/redhat/rhel/tools/rhel-developer-toolbox). StoryPointer module documentation is available [here](https://gitlab.com/redhat/rhel/tools/rhel-developer-toolbox/-/blob/main/doc/source/modules/storypointer.rst).\n\n## How to use\n\n\u003e [!IMPORTANT]\n\u003e\n\u003e 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.\n\n```md\n$ storypointer --help\nUsage: storypointer [options] [string]\n\n📐 Small CLI tool to set JIRA Story Points and Priority\n\nArguments:\n  string                       Issue keys separated by `␣`\n\nOptions:\n  -V, --version                output the version number\n  -c, --component [component]  Issue component, use `!` to exclude component\n  -a, --assignee [assignee]    Issue assignee, use `!` to exclude assignee (default: \"\u003cuser-login\u003e@redhat.com\")\n  -d, --developer [developer]  Issue developer, use `!` to exclude developer\n  -t, --team [team]            Issue AssignedTeam, use `!` to exclude team\n  -j, --jql [jql]              JQL query\n  -l, --legend                 Print legend\n  -n, --nocolor                Disable color output (default: false)\n  -h, --help                   display help for command\n```\n\n\u003e [!NOTE]\n\u003e\n\u003e Only `50` issues are fetched from JIRA at a time. If you want to triage more than `50` issues just run the command again.\n\n\u003e [!TIP]\n\u003e\n\u003e You can disable default values by setting `NODEFAULTS` environment variable to `true`:\n\u003e\n\u003e ```bash\n\u003e NODEFAULTS=true npx storypointer\n\u003e ```\n\u003e\n\u003e Similarly, you can disable color output by setting the `NOCOLOR` environment variable to `true`.\n\n### Examples\n\nSize all issues of the `curl` component:\n\n```md\nstorypointer -c curl\n\nJIRA Version: 9.12.10\nJQL: Project in (RHEL, \"RHEL Miscellaneous\", Fedora) AND (type in (Story, Task) AND (\"Story Points\" is EMPTY OR priority is EMPTY) OR type not in (Story, Task) AND  (\"Story Points\" is EMPTY OR priority is EMPTY OR Severity is EMPTY)) AND status != Closed AND component = curl ORDER BY id DESC\n5 issues are waiting to be sized, prioritized, or set severity.\n\n🐛 RHEL-1234 - In Progress - Assignee\ncurl - Add new feature to curl\nSee more: https://issues.redhat.com/browse/RHEL-1234\n\n? Story Points\n  1\n  2\n❯ 3\n  5\n  8\n  13\n ---\n  SKIP\n  EXIT\n```\n\nYou 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.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fredhat-plumbers-in-action%2Fstorypointer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fredhat-plumbers-in-action%2Fstorypointer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fredhat-plumbers-in-action%2Fstorypointer/lists"}