Welcome to JiraLens, an open-source project fueled by community collaboration. Here are our contribution guidelines.
Encountering challenges or envisioning new features? Share your experiences and thoughts with us through GitHub issues. Your feedback is invaluable in shaping the future of JiraLens!
JiraLens is a Visual Studio Code (VS Code) extension tailored for developers seeking deeper insights into their codebase. It serves as a bridge between your code and the comprehensive information available on Jira pages.
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.
Seamlessly open Jira issues in a dedicated VS Code tab or your preferred external browser.
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.
Gain instant, essential information about the Jira issue while hovering over the inline message.
Experience automatic updates and display of Jira issue content for the active line, ensuring a seamless workflow.
Effortlessly review multiple Jira issues side by side for comprehensive project management.
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
To ensure proper functionality, JiraLens requires the Jira host, the Jira authentication token, and project keys to be configured. Additionally, ensure Jira issue keys are included in commit messages, as they are extracted from there.
You can customize the extension settings either using the VS Code settings editor or by utilizing the commands mentioned above.
If your Jira address begins with https://jira.jiralens.com/..., then set the Jira host as jira.jiralens.com.
Navigate to your Jira profile page, access the Personal Access Tokens tab, and generate a token by clicking the corresponding button.
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.
- Some Jira markdowns like colored texts cannot be rendered, when they exist in the content, Jira issue details will stuck at loading.
- After forward-deleting to pull the next line to the current line, it takes a short while for the inline message to update its position.