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

jira-acli

v0.2.5

Published

CLI for Jira API interaction

Readme

jira-acli

CLI for Jira API interaction

oclif Version Downloads/week

Usage

$ npm install -g jira-acli
$ jira-acli COMMAND
running command...
$ jira-acli (--version)
jira-acli/0.2.5 linux-x64 node-v22.22.0
$ jira-acli --help [COMMAND]
USAGE
  $ jira-acli COMMAND
...

Commands

jira-acli commands

List all jira-acli commands.

USAGE
  $ jira-acli commands [--json] [-c id|plugin|summary|type... | --tree] [--deprecated] [-x | ] [--hidden]
    [--no-truncate | ] [--sort id|plugin|summary|type | ]

FLAGS
  -c, --columns=<option>...  Only show provided columns (comma-separated).
                             <options: id|plugin|summary|type>
  -x, --extended             Show extra columns.
      --deprecated           Show deprecated commands.
      --hidden               Show hidden commands.
      --no-truncate          Do not truncate output.
      --sort=<option>        [default: id] Property to sort by.
                             <options: id|plugin|summary|type>
      --tree                 Show tree of commands.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List all jira-acli commands.

See code: @oclif/plugin-commands

jira-acli help [COMMAND]

Display help for jira-acli.

USAGE
  $ jira-acli help [COMMAND...] [-n]

ARGUMENTS
  [COMMAND...]  Command to show help for.

FLAGS
  -n, --nested-commands  Include all nested commands in the output.

DESCRIPTION
  Display help for jira-acli.

See code: @oclif/plugin-help

jira-acli jira auth add

Add Atlassian authentication

USAGE
  $ jira-acli 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-acli jira auth add

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

jira-acli jira auth test

Test authentication and connection

USAGE
  $ jira-acli jira auth test [--json]

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Test authentication and connection

EXAMPLES
  $ jira-acli jira auth test

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

jira-acli jira auth update

Update existing authentication

USAGE
  $ jira-acli 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-acli jira auth update

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

jira-acli jira board backlogs BOARDID [JQL]

Get all issues from the board's backlog

USAGE
  $ jira-acli 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-acli jira board backlogs 123 'summary ~ "Error saving file" AND status IN ("ready", "in progress")'

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

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

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

jira-acli jira board list [PROJECTID]

Get all boards

USAGE
  $ jira-acli 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-acli jira board list

  $ jira-acli jira board list PROJ

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

jira-acli jira board sprint-issues BOARDID SPRINTID [JQL]

Get all issues belong to the sprint from the board

USAGE
  $ jira-acli 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-acli jira board sprint-issues 123 3068 'summary ~ "Error saving file" AND status IN ("ready", "in progress")'

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

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

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

jira-acli jira board sprints BOARDID

Get all sprints from a board

USAGE
  $ jira-acli 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-acli jira board sprints 123

  $ jira-acli jira board sprints 123 --state active

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

jira-acli jira board versions BOARDID

Get all sprints from a board

USAGE
  $ jira-acli 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-acli jira board versions 123

  $ jira-acli jira board versions 123 --released false

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

jira-acli jira issue assign ISSUEID ACCOUNTID

Assigns an issue to a user

USAGE
  $ jira-acli 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-acli jira issue assign 5b10ac8d82e05b22cc7d4ef5 PROJ-123

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

jira-acli jira issue attachment ISSUEID FILE

Add an attachment to a Jira issue

USAGE
  $ jira-acli 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-acli jira issue attachment ./document.pdf PROJ-123

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

jira-acli jira issue attachment-download ISSUEID ATTACHMENTID [OUTPUTPATH]

Download attachment from an issue

USAGE
  $ jira-acli 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-acli jira issue attachment-download 123 PROJ-123

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

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

jira-acli jira issue comment ISSUEID BODY

Add a comment to an issue

USAGE
  $ jira-acli jira issue comment ISSUEID BODY [--toon]

ARGUMENTS
  ISSUEID  Issue ID or issue key
  BODY     Comment text content

FLAGS
  --toon  Format output as toon

DESCRIPTION
  Add a comment to an issue

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

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

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

jira-acli jira issue comment-delete ISSUEID ID

Delete a comment

USAGE
  $ jira-acli jira issue comment-delete ISSUEID ID

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

DESCRIPTION
  Delete a comment

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

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

jira-acli jira issue create

Create a new issue

USAGE
  $ jira-acli 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-acli jira issue create --fields project='{"key":"PROJ"}' summary="New summary" description="New description" issuetype='{"name":"Dev Task"}'

  $ jira-acli 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-acli jira issue delete ISSUEID

Delete an issue

USAGE
  $ jira-acli jira issue delete ISSUEID

ARGUMENTS
  ISSUEID  Issue ID or issue key to delete

DESCRIPTION
  Delete an issue

EXAMPLES
  $ jira-acli jira issue delete

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

jira-acli jira issue get ISSUEID

Get details of a specific issue

USAGE
  $ jira-acli 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-acli jira issue get PROJ-123

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

jira-acli jira issue search JQL

Searches for issues using JQL

USAGE
  $ jira-acli 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-acli jira issue search 'project=PROJ AND summary ~ "Error saving file" AND status IN ("ready", "in progress")'

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

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

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

jira-acli jira issue transition ISSUEID TRANSITIONID

Performs an issue transition

USAGE
  $ jira-acli jira issue transition ISSUEID TRANSITIONID

ARGUMENTS
  ISSUEID       Issue ID or issue key
  TRANSITIONID  Issue transition ID

DESCRIPTION
  Performs an issue transition

EXAMPLES
  $ jira-acli jira issue transition PROJ-123 123

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

jira-acli jira issue transitions ISSUEID

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

USAGE
  $ jira-acli 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-acli jira issue transitions PROJ-123

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

jira-acli jira issue update ISSUEID

Update an existing issue

USAGE
  $ jira-acli 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-acli jira issue update PROJ-123 --fields summary='New summary' description='New description'

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

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

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

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

jira-acli jira issue update-comment ISSUEID ID BODY

Update a comment

USAGE
  $ jira-acli jira issue update-comment 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-acli jira issue update-comment "
  # Header
  ## Sub-header
  - Item 1
  - Item 2
  ```bash
  ls -a
  ```" 123 PROJ-123

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

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

jira-acli jira issue worklog ISSUEID STARTED TIMESPENT [COMMENT]

Add a worklog to an issue

USAGE
  $ jira-acli 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-acli jira issue worklog PROJ-123 2026-02-03T12:34:00.000+0000 "1d 4h" "
  # Header
  ## Sub-header"

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

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

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

jira-acli jira issue worklog-delete ISSUEID ID

Delete a worklog

USAGE
  $ jira-acli jira issue worklog-delete ISSUEID ID

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

DESCRIPTION
  Delete a worklog

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

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

jira-acli jira issue worklogs ISSUEID

List all boards

USAGE
  $ jira-acli 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-acli jira issue worklogs PROJ-123

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

jira-acli jira project get PROJECTID

Get details of a specific project

USAGE
  $ jira-acli 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-acli jira project get

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

jira-acli jira project list

List all accessible projects

USAGE
  $ jira-acli jira project list [--toon]

FLAGS
  --toon  Format output as toon

DESCRIPTION
  List all accessible projects

EXAMPLES
  $ jira-acli jira project list

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

jira-acli jira user get [ACCOUNTID]

Get user information

USAGE
  $ jira-acli 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-acli jira user get

  $ jira-acli jira user get 5b10ac8d82e05b22cc7d4ef5

  $ jira-acli jira user get -query john

  $ jira-acli jira user get -q [email protected]

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

jira-acli jira user list-assignable ISSUEID

List users that can be assigned to an issue

USAGE
  $ jira-acli 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-acli jira user list-assignable PROJ-123

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

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

jira-acli update [CHANNEL]

update the jira-acli CLI

USAGE
  $ jira-acli update [CHANNEL] [--force |  | [-a | -v <value> | -i]] [-b ]

FLAGS
  -a, --available        See available versions.
  -b, --verbose          Show more details about the available versions.
  -i, --interactive      Interactively select version to install. This is ignored if a channel is provided.
  -v, --version=<value>  Install a specific version.
      --force            Force a re-download of the requested version.

DESCRIPTION
  update the jira-acli CLI

EXAMPLES
  Update to the stable channel:

    $ jira-acli update stable

  Update to a specific version:

    $ jira-acli update --version 1.0.0

  Interactively select version:

    $ jira-acli update --interactive

  See available versions:

    $ jira-acli update --available

See code: @oclif/plugin-update

jira-acli version

USAGE
  $ jira-acli version [--json] [--verbose]

FLAGS
  --verbose  Show additional information about the CLI.

GLOBAL FLAGS
  --json  Format output as json.

FLAG DESCRIPTIONS
  --verbose  Show additional information about the CLI.

    Additionally shows the architecture, node version, operating system, and versions of plugins that the CLI is using.

See code: @oclif/plugin-version