Diffkey

See the Jira ticket on your GitHub branch. File a Jira issue from the code in front of you.

Free: see the Jira issue for your current GitHub branch. Creating a Jira issue from a code selection is a one-time US$19 unlock via Stripe. Frontforge Pty Ltd (ABN 80 600 354 283) is the seller, not Microsoft.

Features

Free Features

• Automatic Jira Key Detection: Detects Jira issue keys (e.g., PROJ-123) from:

  • Current git branch name
  • Recent commit messages
  • GitHub pull request title and body (when GitHub authentication is enabled)

• Issue Panel: View the current Jira issue in the sidebar with:

  • Summary and formatted description (Atlassian Document Format)
  • Status and issue type
  • Assignee information
  • Quick link to open in Jira
  • Choose which browser or profile opens Jira links

• Status Bar Integration: Shows the detected Jira key and status in the VS Code status bar

Paid Features (US$19 one-time license)

• Create Jira Issue from Code Selection:

  • Select code in the editor and create a Jira issue with:
    • Auto-filled summary from the first line of selection
    • Rich description in Atlassian Document Format (ADF) including:
      • File path and line numbers
      • Code snippet (up to 50 lines)
      • Current git branch
      • Git blame information
      • GitHub permalink (when available)
    • Project and issue type selection
    • Support for required fields
  • After creation:
    • Issue key copied to clipboard
    • Options to open in Jira, insert as comment, or add to last commit

• Transition status: Change the current issue's workflow status from the panel

• Assign / unassign: Set the current issue's assignee from the panel

• Post PR to Jira: Post the current pull request onto the Jira ticket

Requirements

• Jira Cloud account: This extension only works with Jira Cloud (not Jira Server or Data Center)
• Jira API token: Create one at https://id.atlassian.com/manage-profile/security/api-tokens
• Git repository: For branch and commit detection
• GitHub authentication (optional): For pull request detection

Getting Started

1. Install the extension
2. Run the command "Diffkey: Setup Jira Connection"
3. Enter your Jira Cloud site URL (e.g., https://yourcompany.atlassian.net)
4. Enter your Jira email
5. Enter your Jira API token
6. Switch to a git branch with a Jira key in the name (e.g., feature/PROJ-123-implement-login)
7. View the issue details in the Diffkey sidebar panel

Creating Issues from Code (Paid Feature)

1. Select code in the editor and run "Diffkey: Create Jira Issue from Selection"
2. Click "Buy License" to purchase via Stripe Checkout (US$19 one-time, personal license, 2 machines)
3. After payment, copy your license key from the success page
4. Run the command "Diffkey: Enter License Key" and paste your license key
5. Select code in the editor
6. Run the command "Diffkey: Create Jira Issue from Selection"
7. Follow the prompts to create the issue

Commands

• Diffkey: Setup Jira Connection - Configure your Jira Cloud connection
• Diffkey: Refresh Current Issue - Manually refresh the issue panel
• Diffkey: Create Jira Issue from Selection - Create a Jira issue from selected code (requires license)
• Diffkey: Post PR to Jira - Post the current pull request on the Jira ticket (requires license)
• Diffkey: Choose Browser for Jira Links - Pick the browser or profile used for Jira links
• Diffkey: Enter License Key - Activate your paid license

Configuration

Settings are available under File > Preferences > Settings (search for "Diffkey"):

• diffkey.jiraSiteUrl - Your Jira Cloud site URL
• diffkey.jiraEmail - Your Jira email address
• diffkey.licenseServerUrl - License server URL (default: Frontforge's Cloudflare Worker)
• diffkey.jiraBrowser - Browser used to open Jira links (ask, system default, or a specific browser)
• diffkey.jiraBrowserProfile - Optional browser profile for Jira links
• diffkey.jiraBrowserPath - Optional custom browser executable path

Note: Your Jira API token and license key are stored securely in VS Code's SecretStorage and never written to settings files or logs.

Privacy & Security

• Your Jira API token is stored in VS Code's secure credential storage
• Your license key is stored in VS Code's secure credential storage
• No telemetry or tracking
• No remote JavaScript execution
• All communication is via HTTPS only with:
  • Your configured Jira Cloud instance
  • GitHub API (when GitHub authentication is enabled)
  • Frontforge license server (for license verification and Stripe checkout)

Support

For issues, questions, or feature requests, please visit: https://github.com/your-repo/diffkey/issues

License

See LICENSE file.

Third-Party Notices

This extension uses the following third-party libraries:

• axios - MIT License
• TypeScript - Apache License 2.0

Publisher: Frontforge Pty Ltd (ABN 80 600 354 283)
Merchant of Record: Frontforge Pty Ltd
Contact: Willem Sevenster, Brisbane, Australia
Payments: Processed via Stripe