A Git extension for retrieving data from JIRA and creating local branches for issues.
# to install $ npm install -g jira-git # to configure $ git jira --configure # help! $ git jira -h
Note: jira-git should not be used with repo clones that are accessed
by multiple users (e.g. on network shares) as your JIRA server,
username, and password are stored per repo in
file is set to be readable only by the owner, but your password is only
base64 encoded, not encrypted.
Display information about the JIRA issue linked to the current branch.
git jira JRA-123
Display information about JIRA issue JRA-123.
git jira --branch JRA-123
Create a new branch, or checkout an existing branch, for JIRA issue JRA-123.
git jira --jql assignee = currentUser() and resolution = unresolved
Display a list of unresolved issues assigned to me.
You may wish to create an alias for this (and any other commonly used JQL queries):
$ git config alias.todo "jira --jql assignee = currentUser() and resolution = unresolved" $ git todo
Once authenticated, you can add or modify the following properties in
The base URL of your JIRA instance (e.g. https://jira.atlassian.com)
Your JIRA username (this is not necessarily your email address)
Your JIRA password
The format string for branches created with
--branch (defaults to
Truncate issue summaries to this length for use in branch names (defaults to 50)
Truncate issue summaries to this length for display in terminal (defaults to 72)