Skip to content

Latest commit

 

History

History
70 lines (45 loc) · 2.21 KB

README.md

File metadata and controls

70 lines (45 loc) · 2.21 KB

cira is a command line tool to interact with JIRA. It relies on steves' node-jira. It supports the following commands:

  • config
  • sprint
  • search
  • issue

config

cira needs a couple of values from you to succesfully interact with JIRA's api. These are:

  • username: Your Atlassian username.
  • password: The password associated with this username.
  • host: The URL where your JIRA instance is hosted. If you leave out the protocol, it defaults to https. You can add the port here as well.
  • version: The API version of your JIRA instance. Defaults to 2. (Optional)
  • project: The key of your default project. You can always override this by running your commands with --project=XX. (Optional)

config is a wizard for supplying these values. They are stored in ./.cira. If you're running a command without a valid configuration, the wizard will run first.

sprint

Commands related to sprints. If empty, it defaults to show.

  • list: List all issues in the open sprints.

    • -m, --mine: Only your issues
    • -o, --open: Only open (ie not resolved) issues
    • -s, --sort: A comma-separated list of fields to sort on (eg --sort=key)
    • -r, --reverse: Reverse the sort order (only works if sort is set)
  • add: Add an issue (or more) to the first open sprint. Separate issues with commas, eg cira sprint add 123 124 125

  • remove: Remove an issue from the sprint it's in. Use it like add.

issue

Issue commands. If empty, it defaults to show. For every command, you can supply a comma-separated list of issue IDs, eg cira issue 123 124 125.

  • show: Show detailed issue views, including comments.

Everything below is a work in progress.

general options:

--fields

  • define which fields should be displayed

--project

  • set project prefix (otherwise, default is used)

cira search

  • search for issues. use jql with -j or use free text search

cira issue [ ... ]

  • display specified issues

cira issue transition [ ... ]

  • move specified issues into next phase of workflow cira issue resolve cira issue accept cira issue start cira issue stop cira issue

cira update update isssues cira list

-p --project: the project of the mentioned issues