npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@hesed/jira

v0.3.0

Published

CLI for Jira API interaction

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

allentcmallentcm

Keywords

oclif

Readme

jira

CLI for Jira API interaction

Version Downloads/week

Install

sdkck plugins install @hesed/jira

Usage

$ npm install -g @hesed/jira
$ jira COMMAND
running command...
$ jira (--version)
@hesed/jira/0.3.0 linux-x64 node-v22.22.1
$ jira --help [COMMAND]
USAGE
  $ jira COMMAND
...

Commands

jira jira auth add

Add Atlassian authentication

USAGE
  $ jira jira auth add -e <value> -t <value> -u <value> [--json]

FLAGS
  -e, --email=<value>  (required) Account email:
  -t, --token=<value>  (required) API Token:
  -u, --url=<value>    (required) Atlassian URL (start with https://):

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Add Atlassian authentication

EXAMPLES
  $ jira jira auth add

See code: src/commands/jira/auth/add.ts

jira jira auth test

Test authentication and connection

USAGE
  $ jira jira auth test [--json]

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Test authentication and connection

EXAMPLES
  $ jira jira auth test

See code: src/commands/jira/auth/test.ts

jira jira auth update

Update existing authentication

USAGE
  $ jira jira auth update -e <value> -t <value> -u <value> [--json]

FLAGS
  -e, --email=<value>  (required) Account email
  -t, --token=<value>  (required) API Token
  -u, --url=<value>    (required) Atlassian instance URL (start with https://)

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Update existing authentication

EXAMPLES
  $ jira jira auth update

See code: src/commands/jira/auth/update.ts

jira jira board backlogs BOARDID [JQL]

Get all issues from the board's backlog

USAGE
  $ jira jira board backlogs BOARDID [JQL] [--fields <value>] [--max <value>] [--start <value>] [--toon]

ARGUMENTS
  BOARDID  Board ID
  [JQL]    JQL expression

FLAGS
  --fields=<value>  Extra list of fields to return
  --max=<value>     Maximum number of items per page
  --start=<value>   Index of the first item to return
  --toon            Format output as toon

DESCRIPTION
  Get all issues from the board's backlog

EXAMPLES
  $ jira jira board backlogs 123 'summary ~ "Error saving file" AND status IN ("ready", "in progress")'

  $ jira jira board backlogs 123 'assignee="[email protected]" AND type=Bug' --max 5 --start 2

  $ jira jira board backlogs 123 'timeestimate > 4h' --fields comment,creator,timeestimate

See code: src/commands/jira/board/backlogs.ts

jira jira board list [PROJECTID]

Get all boards

USAGE
  $ jira jira board list [PROJECTID] [--max <value>] [--start <value>] [--toon]

ARGUMENTS
  [PROJECTID]  Project ID or project key

FLAGS
  --max=<value>    Maximum number of items per page
  --start=<value>  Index of the first item to return
  --toon           Format output as toon

DESCRIPTION
  Get all boards

EXAMPLES
  $ jira jira board list

  $ jira jira board list PROJ

See code: src/commands/jira/board/list.ts

jira jira board sprint-issues BOARDID SPRINTID [JQL]

Get all issues belong to the sprint from the board

USAGE
  $ jira jira board sprint-issues BOARDID SPRINTID [JQL] [--fields <value>] [--max <value>] [--start <value>] [--toon]

ARGUMENTS
  BOARDID   Board ID
  SPRINTID  Sprint ID
  [JQL]     JQL expression

FLAGS
  --fields=<value>  Extra list of fields to return
  --max=<value>     Maximum number of items per page
  --start=<value>   Index of the first item to return
  --toon            Format output as toon

DESCRIPTION
  Get all issues belong to the sprint from the board

EXAMPLES
  $ jira jira board sprint-issues 123 3068 'summary ~ "Error saving file" AND status IN ("ready", "in progress")'

  $ jira jira board sprint-issues 123 3068 'assignee="[email protected]" AND type=Bug' --max 5 --start 2

  $ jira jira board sprint-issues 123 3068 'timeestimate > 4h' --fields comment,creator,timeestimate

See code: src/commands/jira/board/sprint-issues.ts

jira jira board sprints BOARDID

Get all sprints from a board

USAGE
  $ jira jira board sprints BOARDID [--max <value>] [--start <value>] [--state <value>] [--toon]

ARGUMENTS
  BOARDID  Board ID

FLAGS
  --max=<value>    Maximum number of items per page
  --start=<value>  Index of the first item to return
  --state=<value>  Filters sprints in specified states (future, active, closed)
  --toon           Format output as toon

DESCRIPTION
  Get all sprints from a board

EXAMPLES
  $ jira jira board sprints 123

  $ jira jira board sprints 123 --state active

See code: src/commands/jira/board/sprints.ts

jira jira board versions BOARDID

Get all sprints from a board

USAGE
  $ jira jira board versions BOARDID [--max <value>] [--released <value>] [--start <value>] [--toon]

ARGUMENTS
  BOARDID  Board ID

FLAGS
  --max=<value>       Maximum number of items per page
  --released=<value>  Filters versions release state (true, false)
  --start=<value>     Index of the first item to return
  --toon              Format output as toon

DESCRIPTION
  Get all sprints from a board

EXAMPLES
  $ jira jira board versions 123

  $ jira jira board versions 123 --released false

See code: src/commands/jira/board/versions.ts

jira jira issue assign ISSUEID ACCOUNTID

Assigns an issue to a user

USAGE
  $ jira jira issue assign ISSUEID ACCOUNTID

ARGUMENTS
  ISSUEID    Issue ID or issue key
  ACCOUNTID  Account ID of the user

DESCRIPTION
  Assigns an issue to a user

EXAMPLES
  $ jira jira issue assign 5b10ac8d82e05b22cc7d4ef5 PROJ-123

See code: src/commands/jira/issue/assign.ts

jira jira issue attachment ISSUEID FILE

Add an attachment to a Jira issue

USAGE
  $ jira jira issue attachment ISSUEID FILE [--toon]

ARGUMENTS
  ISSUEID  Issue ID or issue key
  FILE     Path to the file to upload

FLAGS
  --toon  Format output as toon

DESCRIPTION
  Add an attachment to a Jira issue

EXAMPLES
  $ jira jira issue attachment ./document.pdf PROJ-123

See code: src/commands/jira/issue/attachment.ts

jira jira issue attachment-download ISSUEID ATTACHMENTID [OUTPUTPATH]

Download attachment from an issue

USAGE
  $ jira jira issue attachment-download ISSUEID ATTACHMENTID [OUTPUTPATH] [--toon]

ARGUMENTS
  ISSUEID       Issue ID or issue key
  ATTACHMENTID  Attachment ID
  [OUTPUTPATH]  Output file path

FLAGS
  --toon  Format output as toon

DESCRIPTION
  Download attachment from an issue

EXAMPLES
  $ jira jira issue attachment-download 123 PROJ-123

  $ jira jira issue attachment-download 123 PROJ-123 ~/Desktop/test.jpg

See code: src/commands/jira/issue/attachment-download.ts

jira jira issue comment ISSUEID BODY

Add a comment to an issue

USAGE
  $ jira jira issue comment ISSUEID BODY [--attach <value>...] [--toon]

ARGUMENTS
  ISSUEID  Issue ID or issue key
  BODY     Comment text content

FLAGS
  --attach=<value>...  Path to a file to upload and embed inline (can be used multiple times)
  --toon               Format output as toon

DESCRIPTION
  Add a comment to an issue

EXAMPLES
  $ jira jira issue comment PROJ-123 "# Header
  - Item 1"

  $ jira jira issue comment PROJ-123 "$(cat content.md)"

  $ jira jira issue comment PROJ-123 "Here is the [bug](https://example.com/bug):
  ![screenshot](./screenshot.png)" --attach ./screenshot.png

  $ jira jira issue comment PROJ-123 "Step 1:
  ![step1](./step1.png)
  Step 2:
  ![step2](./step2.png)" --attach ./step1.png --attach ./step2.mp4

  $ jira jira issue comment PROJ-123 "See also" --attach ./extra.png

See code: src/commands/jira/issue/comment.ts

jira jira issue comment-delete ISSUEID ID

Delete a comment

USAGE
  $ jira jira issue comment-delete ISSUEID ID

ARGUMENTS
  ISSUEID  Issue ID or issue key
  ID       Comment ID to delete

DESCRIPTION
  Delete a comment

EXAMPLES
  $ jira jira issue comment-delete 123 PROJ-123

See code: src/commands/jira/issue/comment-delete.ts

jira jira issue comment-update ISSUEID ID BODY

Update a comment

USAGE
  $ jira jira issue comment-update ISSUEID ID BODY [--toon]

ARGUMENTS
  ISSUEID  Issue ID or issue key
  ID       Comment ID to delete
  BODY     Comment text content

FLAGS
  --toon  Format output as toon

DESCRIPTION
  Update a comment

EXAMPLES
  $ jira jira issue comment-update "
  # Header
  ## Sub-header
  - Item 1
  - Item 2
  ```bash
  ls -a
  ```" 123 PROJ-123

  $ jira jira issue comment-update "$(cat content.md)" 123 PROJ-123

See code: src/commands/jira/issue/comment-update.ts

jira jira issue create

Create a new issue

USAGE
  $ jira jira issue create --fields <value>... [--toon]

FLAGS
  --fields=<value>...  (required) Issue fields in key=value format
  --toon               Format output as toon

DESCRIPTION
  Create a new issue

EXAMPLES
  $ jira jira issue create --fields project='{"key":"PROJ"}' summary="New summary" description="New description" issuetype='{"name":"Dev Task"}'

  $ jira jira issue create --fields project='{"key":"PROJ"}' summary="New summary" timetracking='{"originalEstimate": "5h"}' issuetype='{"name":"Task"}' description='
  # Header
  ## Sub-header
  - Item 1
  - Item 2
  ```bash
  ls -a
  ```'

FLAG DESCRIPTIONS
  --fields=<value>...  Issue fields in key=value format

    Minimum fields required: project, summary, description & issuetype

See code: src/commands/jira/issue/create.ts

jira jira issue delete ISSUEID

Delete an issue

USAGE
  $ jira jira issue delete ISSUEID

ARGUMENTS
  ISSUEID  Issue ID or issue key to delete

DESCRIPTION
  Delete an issue

EXAMPLES
  $ jira jira issue delete

See code: src/commands/jira/issue/delete.ts

jira jira issue get ISSUEID

Get details of a specific issue

USAGE
  $ jira jira issue get ISSUEID [--toon]

ARGUMENTS
  ISSUEID  Issue ID or issue key

FLAGS
  --toon  Format output as toon

DESCRIPTION
  Get details of a specific issue

EXAMPLES
  $ jira jira issue get PROJ-123

See code: src/commands/jira/issue/get.ts

jira jira issue search JQL

Searches for issues using JQL

USAGE
  $ jira jira issue search JQL [--fields <value>] [--max <value>] [--next <value>] [--toon]

ARGUMENTS
  JQL  JQL expression

FLAGS
  --fields=<value>  Extra list of fields to return
  --max=<value>     Maximum number of items per page
  --next=<value>    Token for next page
  --toon            Format output as toon

DESCRIPTION
  Searches for issues using JQL

EXAMPLES
  $ jira jira issue search 'project=PROJ AND summary ~ "Error saving file" AND status IN ("ready", "in progress")'

  $ jira jira issue search 'assignee="[email protected]" AND type=Bug' --max 5 --next CiEjU3RyaW5nJlUwRlVTRkpGUlE9PSVJbnQmTkRFd05qST0QAhiQqtD4wTMiKGFzc2lnbmVlPSJhbGxlbkBpbmN1YmU4LnNnIiBBTkQgdHlwZT1CdWcqAltd

  $ jira jira issue search 'timeestimate > 4h' --fields comment,creator,timeestimate

See code: src/commands/jira/issue/search.ts

jira jira issue transition ISSUEID TRANSITIONID

Performs an issue transition

USAGE
  $ jira jira issue transition ISSUEID TRANSITIONID

ARGUMENTS
  ISSUEID       Issue ID or issue key
  TRANSITIONID  Issue transition ID

DESCRIPTION
  Performs an issue transition

EXAMPLES
  $ jira jira issue transition PROJ-123 123

See code: src/commands/jira/issue/transition.ts

jira jira issue transitions ISSUEID

Get transitions that can be performed by the user on an issue

USAGE
  $ jira jira issue transitions ISSUEID [--toon]

ARGUMENTS
  ISSUEID  Issue ID or issue key

FLAGS
  --toon  Format output as toon

DESCRIPTION
  Get transitions that can be performed by the user on an issue

EXAMPLES
  $ jira jira issue transitions PROJ-123

See code: src/commands/jira/issue/transitions.ts

jira jira issue update ISSUEID

Update an existing issue

USAGE
  $ jira jira issue update ISSUEID --fields <value>...

ARGUMENTS
  ISSUEID  Issue ID or issue key

FLAGS
  --fields=<value>...  (required) Issue fields to update in key=value format

DESCRIPTION
  Update an existing issue

EXAMPLES
  $ jira jira issue update PROJ-123 --fields summary='New summary' description='New description'

  $ jira jira issue update PROJ-123 --fields description='
  # Header
  ## Sub-header
  - Item 1
  - Item 2
  ```bash
  ls -a
  ```'

  $ jira jira issue update PROJ-123 --fields description="$(cat content.md)"

  $ jira jira issue update PROJ-123 --fields timetracking='{"originalEstimate": "5h"}'

See code: src/commands/jira/issue/update.ts

jira jira issue worklog ISSUEID STARTED TIMESPENT [COMMENT]

Add a worklog to an issue

USAGE
  $ jira jira issue worklog ISSUEID STARTED TIMESPENT [COMMENT] [--toon]

ARGUMENTS
  ISSUEID    Issue ID or issue key
  STARTED    Datetime the worklog effort started
  TIMESPENT  Time spent working on the issue
  [COMMENT]  Comment text content

FLAGS
  --toon  Format output as toon

DESCRIPTION
  Add a worklog to an issue

EXAMPLES
  $ jira jira issue worklog PROJ-123 2026-02-03T12:34:00.000+0000 "1d 4h" "
  # Header
  ## Sub-header"

  $ jira jira issue worklog PROJ-123 $(date +"%Y-%m-%dT%H:%M:%S.000%z") 6h "Fix test"

  $ jira jira issue worklog PROJ-123 $(date +"%Y-%m-%dT08:30:00.000%z") 6h

See code: src/commands/jira/issue/worklog.ts

jira jira issue worklog-delete ISSUEID ID

Delete a worklog

USAGE
  $ jira jira issue worklog-delete ISSUEID ID

ARGUMENTS
  ISSUEID  Issue ID or issue key
  ID       Worklog ID to delete

DESCRIPTION
  Delete a worklog

EXAMPLES
  $ jira jira issue worklog-delete 123 PROJ-123

See code: src/commands/jira/issue/worklog-delete.ts

jira jira issue worklogs ISSUEID

List all boards

USAGE
  $ jira jira issue worklogs ISSUEID [--max <value>] [--start <value>] [--toon]

ARGUMENTS
  ISSUEID  Issue ID or issue key

FLAGS
  --max=<value>    Maximum number of items per page
  --start=<value>  Index of the first item to return
  --toon           Format output as toon

DESCRIPTION
  List all boards

EXAMPLES
  $ jira jira issue worklogs PROJ-123

See code: src/commands/jira/issue/worklogs.ts

jira jira project get PROJECTID

Get details of a specific project

USAGE
  $ jira jira project get PROJECTID [--toon]

ARGUMENTS
  PROJECTID  Project ID or project key

FLAGS
  --toon  Format output as toon

DESCRIPTION
  Get details of a specific project

EXAMPLES
  $ jira jira project get

See code: src/commands/jira/project/get.ts

jira jira project list

List all accessible projects

USAGE
  $ jira jira project list [--toon]

FLAGS
  --toon  Format output as toon

DESCRIPTION
  List all accessible projects

EXAMPLES
  $ jira jira project list

See code: src/commands/jira/project/list.ts

jira jira user get [ACCOUNTID]

Get user information

USAGE
  $ jira jira user get [ACCOUNTID] [-q <value>] [--toon]

ARGUMENTS
  [ACCOUNTID]  User account ID

FLAGS
  -q, --query=<value>  Query string that matches user attributes
      --toon           Format output as toon

DESCRIPTION
  Get user information

EXAMPLES
  $ jira jira user get

  $ jira jira user get 5b10ac8d82e05b22cc7d4ef5

  $ jira jira user get -query john

  $ jira jira user get -q [email protected]

See code: src/commands/jira/user/get.ts

jira jira user list-assignable ISSUEID

List users that can be assigned to an issue

USAGE
  $ jira jira user list-assignable ISSUEID [-q <value>] [--toon]

ARGUMENTS
  ISSUEID  Issue ID or issue key

FLAGS
  -q, --query=<value>  Query string that matches user attributes
      --toon           Format output as toon

DESCRIPTION
  List users that can be assigned to an issue

EXAMPLES
  $ jira jira user list-assignable PROJ-123

  $ jira jira user list-assignable PROJ-123 -q john

See code: src/commands/jira/user/list-assignable.ts