Add jira issues to org-mode
Import a jira issue into org-mode as a todo.
Gojira is built on top of org-jira and acts as a much simpler alternative interface for using org-jira. It allows you to use an existing org file and import issue as single standalone entities.
It’s currently only one way. Jira->Org. I may someday add the other direction, but I doubt it.
I was tired of copying, pasting, and formatting jira tasks into org files. Org-jira is nice but it didn’t fit the way I wanted to use it. I have existing org files and structures I want to continue using. I just want to be able to insert a jira task into an org file.
Questions/comments [email protected]
There are still a lot of things I would like to add, but it works. I use it everyday.
For details see TODOs
below.
Install org-jira from https://github.com/ahungry/org-jira
Clone this repo somewhere. For example ~/elisp/
and load it with
use-package
(use-package gojira
:load-path "~/elisp/gojira/"
:bind (("C-c j" . gojira-insert-issue-as-org)
("C-c u" . gojira-refresh-issue)
("C-c U" . gojira-refresh-issue-for-id)))
Set your jira url
(setq jiralib-url "https://jira.example.com")
To pull an issue from jira into your org file call
gojira-insert-issue-as-org
. You will be prompted for the jira issue key and
the issue will be inserted at the same level as the heading at point.
It’s easiest to map that to a keybinding.
The install section above binds this command to C-c j
Update means jira->org. I like to take a lot of notes in tasks so updates
will not alter or remove any content not under the Description
or
Comments
headings. So don’t add anything there you want to keep through
an update.
To update the issue the point is currently in call gojira-refresh-issue
.
This is bound to C-c u
in the install section.
gojira-refresh-issue-for-id
is an interactive function that will prompt
for the issue key to update.
This is bound to C-c U
in the install section.