Jira Copilot

A VS Code extension that integrates Jira issue management directly into GitHub Copilot, enabling you to fetch and interact with Jira issues through natural language queries via the Jira Cloud API.

Features

• GitHub Copilot Integration: Use Jira as a language model tool within GitHub Copilot
• Jira Issue Fetching: Retrieve detailed Jira issue information by issue key
• Workspace Configuration: Store your Jira instance URL and credentials securely at the workspace level
• Interactive Setup: One-command setup wizard to configure your Jira connection
• Secure Authentication: Uses basic authentication with secure token storage

Quick Start

1. Install the Extension

Install "Jira Copilot" from the VS Code Extensions marketplace.

2. Run Setup

1. Open the VS Code command palette (Cmd+Shift+P / Ctrl+Shift+P)
2. Type "Jira Copilot: Setup" and press Enter
3. Follow the prompts:
   • Jira Instance URL: Enter your Jira Cloud instance URL (e.g., https://mycompany.atlassian.net)
   • Email Address: Enter your Atlassian email address
   • Personal Access Token: Enter your Jira personal access token

3. Use with GitHub Copilot

Once configured, you can ask GitHub Copilot to fetch Jira issues:

• "Fetch Jira issue PROJ-123"
• "Get the details for issue ABC-456"
• "Show me information about issue KEY-789"

The extension will prompt for confirmation before fetching and return complete issue details.

Getting a Jira Personal Access Token

1. Log in to your Atlassian Jira instance
2. Click your profile icon → Account settings → Security → API tokens
3. Click Create API token
4. Give it a descriptive label (e.g., "VS Code Jira Copilot")
5. Copy the generated token
6. Use this token in the Jira Copilot setup process

Important: Keep your token secure. Never share it or commit it to version control.

Configuration

Configuration is stored in your VS Code workspace settings (.vscode/settings.json):

{
  "jiracopotilot.instanceUrl": "https://mycompany.atlassian.net",
  "jiracopotilot.email": "your.email@example.com"
}

The personal access token is stored securely in VS Code's secret storage and is not visible in settings files.

Reconfigure Settings

To update your Jira configuration at any time:

1. Run the "Jira Copilot: Setup" command again
2. Enter new values when prompted
3. Existing configuration will be overwritten

Requirements

• VS Code 1.109.0 or later
• GitHub Copilot extension (for using Jira as a language model tool)
• Atlassian Jira Cloud account with API token access

Troubleshooting

"Jira Copilot is not fully configured"

Solution: Run the "Jira Copilot: Setup" command from the command palette and complete all steps.

"Issue not found" error

Solution: Verify that:

• The issue key is correct (e.g., PROJ-123)
• You have access to the issue in your Jira instance
• Your Jira instance URL is correct

"Authentication failed" error

Solution: Verify that:

• Your email address is correct
• Your personal access token is valid and hasn't expired
• Your Jira instance URL uses HTTPS and is correct

Release Notes

0.1.0

• Interactive setup command with guided configuration
• Workspace-level settings storage for Jira instance and email
• Secure token storage using VS Code SecretStorage
• Updated Jira fetch tool to use dynamically configured settings
• Removed environment variable dependency
• Improved error handling and user feedback
• Marketplace-ready extension

0.0.1

• Initial release with basic Jira fetch functionality via hardcoded configuration

Privacy & Security

• Your personal access token is stored securely in VS Code's system-level secret storage
• Configuration is workspace-specific and not synced globally
• The extension only communicates with your configured Jira instance
• No telemetry is collected