UIFix-AI

🚀 Your AI-powered Jira companion for VS Code

Automatically fix bugs logged in Jira using AI assistance • Create branches instantly • Integrate with GitHub, GitLab, or Bitbucket

All without leaving your IDE ⚡

💡 What is UIFix-AI?

Transform bug fixing into a one-click operation

UIFix-AI is your intelligent automation layer between Jira and your codebase. Here's what happens when you select a bug:

Step	Action	Powered By
1️⃣	AI investigates the bug and root cause	🤖 GitHub Copilot
2️⃣	Creates branch automatically	🔀 GitHub/GitLab/Bitbucket
3️⃣	Applies fixes with AI-generated code	✨ Smart Code Generation
4️⃣	Updates Jira with progress & comments	📝 Auto-sync

⚡ Average time to fix: 2 minutes ⚡

🚦 Quick Start (4 Easy Steps)

1️⃣ Install

One-click install → Get it now

2️⃣ Connect

Link Jira & Git → Sidebar button or Jira: Configure

3️⃣ Initialize (Recommended)

Setup project context → Ctrl+Shift+P → Initialize Workspace

4️⃣ Fix!

Select & automate → Right-click bug → "Fix with AI"

⚙️ Setup Guide

📌 Step 1: Jira Authentication

🔐 Option 1: Sidebar Button (Recommended)
1. Click UIFix-AI icon in Activity Bar (left sidebar)
2. Click "Configure Jira" button
3. Enter your credentials in the form
⌨️ Option 2: Command Palette

Press Ctrl+Shift+P (Windows/Linux) or Cmd+Shift+P (Mac), then:
Jira: Configure
Required Info:

🌐 Jira URL: https://yourcompany.atlassian.net

📧 Email: Your Jira account email

🔑 API Token: Generate here →

🔀 Step 2: Choose Your Git Platform

Pick the platform your team uses:

🐙 Option A: GitHub

Setup Built-in VS Code authentication • Sign in via sidebar

Features ✓ Auto branch creation
✓ GitHub Copilot integration
✓ Link commits to Jira

🦊 Option B: GitLab

Setup Click "Authenticate GitLab" button or run GitLab: Authenticate

Features ✓ View/manage Merge Requests
✓ Auto branch creation
✓ Link MRs to Jira

🪣 Option C: Bitbucket

Setup Click "Authenticate Bitbucket" button or run Bitbucket: Authenticate

Features ✓ View/manage Pull Requests
✓ Auto branch creation
✓ Link PRs to Jira

� Step 3: Initialize Workspace (Recommended)

First time in a new repository? Run this once to boost AI fix quality:
Ctrl+Shift+P → "Jira: Initialize Workspace with Copilot Instructions"
This creates official VS Code Copilot instruction files that help AI understand your:

🏗️ Technology stack & architecture

📏 Coding standards & conventions

♿ Accessibility requirements

🧪 Build & test processes

Creates: .github/copilot-instructions.md + .github/instructions/*.instructions.md
Time: ~30 seconds | Result: Better, more accurate automated fixes

📖 Full Guide

🐛 Step 4: Start Fixing Bugs

🎯 Method 1: From Jira Issues

1. Open UIFix-AI sidebar (left panel)
2. Browse your assigned Jira bugs
3. Right-click any bug → "Fix with AI"
4. ✨ Watch the magic happen!

📊 Method 2: From Excel Upload

1. Prepare Excel file with bug data
2. Run: Jira: Upload Excel Bugs
3. Select bugs to fix
4. Bulk processing activated!

🎬 How It Works

⚡ The AI Fix Workflow ⚡

graph LR
    A[📋 Browse Bugs] --> B[🎯 Select Bug]
    B --> C[🤖 AI Analysis]
    C --> D[🌿 Create Branch]
    D --> E[✨ Apply Fix]
    E --> F[✅ Update Jira]

Step	What Happens	Time
1️⃣ Browse	View bugs from Jira or upload Excel spreadsheet	5 sec
2️⃣ Select	Right-click bug and select "Fix with AI"	2 sec
3️⃣ Analyze	GitHub Copilot investigates bug and generates fix	30 sec
4️⃣ Branch	Auto-creates feature branch (customizable naming)	3 sec
5️⃣ Apply	AI applies code changes to your workspace	15 sec
6️⃣ Sync	Status and comments updated in Jira automatically	5 sec

Total Time: ~60 seconds | Your Time: ~7 seconds 🎉

🌿 Smart Branching Strategy

Every bug gets its own feature branch automatically

🎨 Customize Branch Naming

Add to your VS Code settings.json:

{
  "uifixai.branchPrefix": "bugfix/",
  "uifixai.branchFormat": "[prefix][ticket-key]-[summary]",
  "uifixai.branchSeparator": "-"
}

Examples:

bugfix/PROJ-123-fix-login-error
feature/PROJ-456-add-validation
hotfix/PROJ-789-security-patch

Supported Variables

Variable	Description	Example
`[prefix]`	Custom prefix	`bugfix/`, `feature/`
`[ticket-key]`	Jira issue key	`PROJ-123`
`[summary]`	Issue summary	`fix-login-error`
`[type]`	Issue type	`bug`, `story`, `task`

📥 Loading Bugs: Choose Your Style

🔵 Method 1: Jira Integration

Live connection to your Jira workspace

✓ View all assigned bugs in sidebar
✓ Real-time sync
✓ Filter by status/priority/sprint
✓ Advanced JQL search

Best for: Day-to-day workflow

📊 Method 2: Excel Import

Bulk upload from spreadsheets

✓ Upload Excel with bug data
✓ Process multiple bugs at once
✓ Required: Summary, Description, Type
✓ Real-time progress tracking

Best for: Migration or bulk operations

Command: Jira: Upload Excel Bugs

⌨️ Command Reference

All commands accessible via Command Palette (Ctrl+Shift+P / Cmd+Shift+P)

🎫 Jira Commands

Command	Description
`Jira: Configure`	Setup Jira authentication
`Jira: Clear Credentials`	Remove stored credentials
`Jira: Validate Configuration`	Test Jira connection
`Jira: Refresh`	Refresh bug list
`Jira: Clear Cache`	Clear cached data

📊 Excel Import Commands

Command	Description
`Jira: Upload Excel Bugs`	Bulk import bugs from Excel
`Excel: Download Template`	Get Excel template file

🤖 AI & Fix Commands

Command	Description
`Jira: Fix with AI`	AI-powered bug fixing (right-click context)
`Jira: Investigate with Copilot`	Generate AI context file

🐙 GitHub Commands

Command	Description
Built-in VS Code Authentication	Sign in via VS Code account menu
`Git: Create Branch`	Manual branch creation

🦊 GitLab Commands

Command	Description
`GitLab: Authenticate`	OAuth authentication
`GitLab: View Merge Requests`	Browse MRs in sidebar

🪣 Bitbucket Commands

Command	Description
`Bitbucket: Authenticate`	OAuth authentication
`Bitbucket: View Pull Requests`	Browse PRs in sidebar

🔧 Troubleshooting

💡 Quick Tip: Most issues resolve with Jira: Clear Cache + VS Code reload

If the table below doesn't help, 🐛 raise an issue here.

Issue	Solution
Jira bugs not displaying	1. Verify credentials with `Jira: Validate Configuration` 2. Check bugs are assigned to you in Jira 3. Run `Jira: Clear Cache` and restart VS Code
GitHub Copilot not working	1. Verify GitHub Copilot extension is installed 2. Check `jiraExtension.enableCopilotTools` is enabled 3. Verify active Copilot subscription
Authentication failing	1. Confirm Jira URL format (no trailing slash) 2. Regenerate API token if expired 3. Run `Jira: Clear Credentials` and reconfigure
Branch creation failing	1. Ensure Git repository is initialized 2. Check branching strategy settings 3. Verify write permissions to repository
GitLab/Bitbucket OAuth failing	1. Confirm repository uses correct remote 2. Complete OAuth flow in browser 3. Check workspace access permissions
Excel import failing	1. Use provided template format 2. Verify required columns exist 3. Check file size is under 5MB
AI fix not applying	1. Ensure files are not read-only 2. Check workspace folder is open 3. Review Output panel for errors

✅ Compatibility Matrix

Platform	Version	Status
Jira Cloud	-	✅ Fully Supported
Jira Server/Data Center	Atlassian Support Policy	✅ Supported
GitHub	Cloud	✅ Fully Supported
GitLab	Cloud	✅ Fully Supported
Bitbucket	Cloud	✅ Fully Supported
GitHub Copilot	Latest	✅ Required for AI fixes
VS Code	>= 1.85.0	✅ Required

If you're using Jira Server/Data Center, find your version in the page footer to verify support.

📚 Additional Documentation

Setup Guide - Detailed installation instructions
Features Documentation - Complete feature specifications
Excel Integration Guide - Excel template and import guide
Bitbucket Integration - Bitbucket OAuth setup
GitLab Integration - GitLab OAuth setup

👥 For Contributors

Installation and Development:

Clone the repository and run npm install
Copy .vscode/launch.json.example to .vscode/launch.json
Press F5 to launch Extension Development Host
Make changes and reload (⟲ button) to test

Tests:

npm run test

Contributing: Contributions welcome! See CONTRIBUTING.md for guidelines.

🔒 Security & Privacy

🛡️ Your Data is Safe

✅ Encrypted Storage
API tokens in VS Code's secret vault

✅ Direct Connection
No middleman servers

✅ HTTPS Only
All API calls encrypted

🕵️ Your Privacy Matters

✅ Zero Telemetry
We don't track your usage

✅ Open Source
Full code transparency

✅ Local Processing
Your code stays on your machine

💬 Support & Community

🐛

Bug Reports
GitHub Issues

💬

Discussions
Community Forum

📖

Documentation
Full Docs

📝

Changelog
Release Notes

📄 License

Proprietary License - See LICENSE file

⭐ Enjoying UIFix-AI?

Help us grow! Give us a star ⭐ on GitHub and leave a review on the marketplace!

Made with ❤️ by UI-Tech @ HCLTech

🚀 Install now! | 📖 Documentation | 🐛 Report Issue