Skip to content

AliAhmedNada/ojira

Repository files navigation

ojira Logo

ojira - AI Powered Jira Description Generator

ojira helps you quickly generate well-structured Jira task descriptions using your local Ollama AI models. Compatible with both cloud-based and private Jira instances, ojira lets you save time and improve your Jira tickets with AI-generated content based on existing issue details while keeping your data secure on your local network.

ojira Logo
🔒 Works with both Atlassian Cloud and Self-Hosted Jira 🔒

Chrome Web Store

🎉 Celebrating Version 5.1.0!

We're excited to announce version 5.1.0 of ojira with significant improvements:

  • Enhanced User Interface: Completely refreshed UI for a more intuitive experience
  • Dynamic Issue Creation: Generate issues and tasks dynamically based on the selected project
  • Project-Specific Issue Types: Automatically load appropriate issue types for each project
  • Improved AI Generation: Better context handling for more relevant descriptions

📺 Demo Video

Video Title

Demo Screenshots

Creating a New Jira Issue
Creating a new Jira issue with ojira

ojira in Action
ojira reading and processing Jira ticket information

Key Features

✅ Uses your local Ollama AI models to generate Jira descriptions
✅ Works with both cloud and private Jira instances ✅ Fetches context from active Jira pages
✅ Allows customizable prompts
✅ Seamlessly integrates with Jira
✅ Keeps your data local and secure

Quick Setup

ojira Chrome Extension

  1. Requirements:
    • 🌐 Google Chrome browser
    • 🤖 Ollama installed and running
    • 🔄 Jira account with access to create/edit issues (cloud or private)
    • 🔑 Jira Personal Access Token (PAT)
    • 🔒 For private instances: Your Jira base URL

Installation & Configuration

Chrome Web Store

Option 1: Install from Chrome Web Store (Recommended)

  1. Visit the Chrome Web Store page and click "Add to Chrome"
  2. Confirm the installation when prompted
  3. Pin the extension to your toolbar for easy access

Option 2: Manual Installation (Developer Mode)

  1. Install the Extension:

    • Unzip the ojira_extension_vX.X.X.zip file
    • Go to chrome://extensions and enable "Developer mode"
    • Click "Load unpacked" and select the extension folder
    • Verify the extension icon appears in Chrome toolbar

    Enable Developer Mode
    Step 1: Enable Developer Mode in Chrome Extensions

    Click Load Unpacked
    Step 2: Click the Load Unpacked button

    Select Extension Folder
    Step 3: Select the ojira extension folder

    Extension Installed
    Step 4: Verify the extension is installed

  2. Configure Jira PAT and URL:

    • Generate a PAT from your Jira profile with write permissions
    • Right-click the ojira icon in Chrome and select "Options"
    • Paste your PAT and save
    • For private Jira instances, enter your Jira base URL (e.g., https://jira.your-company.com)

    Configuration Options
    Configuration of the ojira extension options

    Cloud Jira URL Private Jira URL Example
    https://your-company.atlassian.net https://jira.your-company.com
    Examples of Jira URL configuration for different environments
  3. Setup Ollama:

    • Start Ollama with CORS enabled:
      OLLAMA_ORIGINS=* ollama serve
    • Pull a model if needed:
      ollama pull llama3
    • In extension Options, select your preferred model
  4. Select Model:

    • In the extension Options, choose which Ollama model to use
    • Click "Save Model Selection"

How to Use

Step 1 Step 2 Step 3
🔍 Open a Jira Issue 🧠 Add AI Instructions ✅ Insert into Jira
  1. 🌐 Open a Jira Issue in your browser
  2. 🖱️ Click the ojira extension icon in your toolbar
  3. 💬 Add Instructions (optional) to guide the AI
  4. 🚀 Click "Generate Description" to create content
  5. 📝 Review & Edit the generated description
  6. 💾 Click "Insert into Jira" to update your ticket

The extension automatically fetches issue details including summary, type, assignee, project name, and existing description to provide context to the AI.

ojira in Action
Works identically on cloud and private Jira instances

Common Issues

Issue Solution
⚠️ 403 Forbidden Error Start Ollama with OLLAMA_ORIGINS=* ollama serve
🔌 Can't Connect to API Make sure Ollama is running (http://localhost:11434)
📦 No Models Available Run ollama pull llama3 or your preferred model
🔑 PAT Not Working Ensure your Jira token has write permissions
🔒 Private Jira Access Verify your Jira base URL is correctly set in options

License

This project is licensed under the MIT License with attribution requirements - see the LICENSE file for details.

More Help

For a complete walkthrough, watch our demo video


ojira logo

ojira - AI Powered Jira Description Generator
Available on the Chrome Web Store

About

Ojira plugin with ollama

Resources

License

Security policy

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •