Skip to content
Branch: master
Find file History
Type Name Latest commit message Commit time
Failed to load latest commit information. MOdified README to reflect changes for myissues command Mar 27, 2018
_jira Change the br argument to branch to follow PR #6678. (#6680) Apr 15, 2018
jira.plugin.zsh Merge branch 'master' into master May 8, 2019

Jira plugin

CLI support for JIRA interaction


This plugin provides command line tools for interacting with Atlassian's JIRA bug tracking software.

The interaction is all done through the web. No local installation of JIRA is necessary.

In this document, "JIRA" refers to the JIRA issue tracking server, and jira refers to the command this plugin supplies.


This plugin supplies one command, jira, through which all its features are exposed. Most forms of this command open a JIRA page in your web browser.

jira            # performs the default action

jira new        # opens a new issue
jira dashboard  # opens your JIRA dashboard
jira reported [username]  # queries for issues reported by a user
jira assigned [username]  # queries for issues assigned to a user
jira myissues   # queries for you own issues
jira branch     # opens an existing issue matching the current branch name
jira ABC-123    # opens an existing issue
jira ABC-123 m  # opens an existing issue for adding a comment

Debugging usage

These calling forms are for developers' use, and may change at any time.

jira dumpconfig   # displays the effective configuration


The URL for your JIRA instance is set by $JIRA_URL or a .jira_url file.

Add a .jira-url file in the base of your project. You can also set $JIRA_URL in your ~/.zshrc or put a .jira-url in your home directory. A .jira-url in the current directory takes precedence, so you can make per-project customizations.

The same goes with .jira-prefix and $JIRA_PREFIX. These control the prefix added to all issue IDs, which differentiates projects within a JIRA instance.

For example:

cd to/my/project
echo "" >> .jira-url

(Note: The current implementation only looks in the current directory for .jira-url and .jira-prefix, not up the path, so if you are in a subdirectory of your project, it will fall back to your default JIRA URL. This will probably change in the future though.)


  • $JIRA_URL - Your JIRA instance's URL
  • $JIRA_NAME - Your JIRA username; used as the default user for assigned/reported searches
  • $JIRA_PREFIX - Prefix added to issue ID arguments
  • $JIRA_RAPID_BOARD - Set to true if you use Rapid Board
  • $JIRA_DEFAULT_ACTION - Action to do when jira is called with no arguments; defaults to "new"


Your default web browser, as determined by how open_command handles http:// URLs, is used for interacting with the JIRA instance. If you change your system's URL handler associations, it will change the browser that jira uses.

You can’t perform that action at this time.