https://github.com/adyscorpius/logseq-jira

A simple Jira plugin for Logseq users
https://github.com/adyscorpius/logseq-jira

jira-sync logseq-plugin

Last synced: 4 months ago
JSON representation

A simple Jira plugin for Logseq users

• Host: GitHub
• URL: https://github.com/adyscorpius/logseq-jira
• Owner: adyscorpius
• License: mit
• Created: 2022-11-08T06:30:18.000Z (over 1 year ago)
• Default Branch: master
• Last Pushed: 2023-10-06T03:59:40.000Z (9 months ago)
• Last Synced: 2024-01-16T02:42:15.084Z (5 months ago)
• Topics: jira-sync, logseq-plugin
• Language: TypeScript
• Homepage:
• Size: 547 KB
• Stars: 30
• Watchers: 5
• Forks: 9
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Lists

• awesome-logseq - logseq-jira - Update Jira ticket details in your active blocks in Logseq. (🔌 Plugins)

README

        
[![Build plugin](https://github.com/adyscorpius/logseq-jira/actions/workflows/publish.yml/badge.svg)](https://github.com/adyscorpius/logseq-jira/actions/workflows/publish.yml)

## Logseq Jira Sync Plugin

Are you tired of copying Jira links, only to not remember which Jira is it? What about getting updates without clicking on each link? Or querying blocks within Logseq based on ticket status?

Bring your Jira issue status and summaries into Logseq with Logseq-Jira. Include important fields like Priority, Status, Assignee and Reporter as block properties to then query within Logseq as needed.

Check out the discussion on Logseq Forums by [clicking here](https://discuss.logseq.com/t/logseq-jira-plugin/12414?u=adit)

## What it does?

![Demo](./demo.gif)

## Current Functionality

1. Use the slash command "Update Jira Issue" to replace issue keys (PM-100, ISS-12143, etc.) or Jira issue links like subdomain.atlassian.net/browse/PM-100 with `[|](https://orgname.atlassian.net/browse/)` formats.

2. Use optional block properties to keep the text as in, but add key issue fields as block properties.

3. *NEW* Supports two Jira Cloud instances. Keep your work JIRA separate from your personal JIRA.

### Known Limitations

1. Earlier issue details are not automatically updated. (Need to check performance impact).

3. Supports **Jira Cloud only**. 

### Roadmap

- [X]  Refresh summary on rerun on existing links.

- [X]  Add more fields to help with context of the tickets

- [X]  Support for multiple organizations.

- [ ]  Auto refresh/update all links when page is loaded.

- [ ]  Auto refresh all Jira links across vault (need to verify performance impact on doing this).

- [ ]  Create your own Link description format with Jira variables ( '{issueKey} - {status} - {summary}' )

### Download

The plugin is available to download directly from Logseq's Plugins marketplace. Alternatively, you can download the latest release from [Releases](https://github.com/adyscorpius/logseq-jira/releases) published on Github.

### How to build the plugin

- Git clone the repository to your local system. Or download and extract to a known path.

- `npm install && npm run build` in terminal to install dependencies and generate distribution folder.

- Enable Developer mode in Logseq by going to Settings -> Advanced -> Turn on Developer Mode.

- `Load unpacked plugin` in Logseq Desktop client and select the folder for the plugin on your disk.

- For updates, git pull the main branch and 'Reload Package' under Plugins > Logseq Jira.

### Release process

- Update version in package.json

- Add all updates to master branch

- Tag the latest commit with new version.