JiraLens

Refer to this documentation for contribution guidelines.

Introduction

Overview

JiraLens is a Visual Studio Code (VS Code) extension tailored for developers seeking deeper insights into their codebase. It servers as a bridge between your code and the comprehensive information available on Jira pages.

Why JiraLens?

While extensions like GitLens offer valuable insights already, they often fall short of the wealth of information found on Jira. JiraLens seamlessly integrates with Jira pages, providing quick access to crucial details, such as the broader objective, the fix version of the change, and more.

Features

Status Bar Item

Seamlessly open Jira issues in a dedicated VS Code tab or your preferred external browser.

Inline Message

Receive quick information about the committer, relative commit time, Jira issue key, and commit message.

The content of the inline message can be easily configured.

Hover Modal

Gain instant, essential information about the Jira issue while hovering over the inline message.

Activity Bar Item

Experience automatic updates and display of Jira issue content for the active line, ensuring a seamless workflow.

Issue Tab

Effortlessly review multiple Jira issues side by side for comprehensive project management.

Comprehensive Commands

Easily tailor the extension settings to suit your preferences with a simple and intuitive configuration approach.

// Type VS Code commands using: Ctrl/Command + Shift + P
// Available commands:
Set the Jira Host
Set the Bearer Token (Personal Access Token) for Jira Authentication
Add a Jira Project Key
Delete a Jira Project Key
Set Whether to Show the Committer in Inline Message
Set Whether to Show the Relative Commit Time in Inline Message
Set Whether to Show the Jira Issue Key in Inline Message
Set Whether to Show the Commit Message in Inline Message

Extension Setup

To ensure proper functionality, JiraLens requires configuration of the Jira host, the Jira authentication token, and project keys. Additionally, ensure Jira issue keys are included in commit messages, as they are extracted from there.

Jira Host

If your Jira address begins with https://jira.jiralens.com/..., then set the Jira host as jira.jiralens.com.

Bearer Token (Personal Access Token)

Navigate to your Jira profile page, access the Personal Access Tokens tab, and generate a token by clicking the corresponding button.

Project Keys

Refer to this documentation for the definition of Jira issue key and Jira project key. If an issue's key is JRL-123, then its corresponding project key is JRL.

Known Issues