Jira Sprint Report AI Agent

A premium, AI-powered dashboard that connects to your Jira Cloud instance, analyzes sprint performance using advanced LLMs (via OpenRouter), and generates professional PDF reports.

✨ Features

• Jira Integration: Seamlessly fetches sprints and user stories from Jira Software Cloud.
• AI Analysis: Uses openai/gpt-5.2 to generate executive summaries, improved velocity metrics, and bottleneck identification.
• Premium UI: Commercial-grade SaaS interface with dark/light theming, glassmorphism, and smooth animations.
• PDF Export: Generates high-fidelity PDF reports using Puppeteer.
• Interactive Dashboard:
  • Collapsible ticket lists.
  • "Thinking" modal for AI process visibility.
  • Sprint history sidebar.

🚀 Getting Started

Prerequisites

• Node.js (v18 or higher)
• Jira Cloud Account (Email & API Token)
• OpenRouter Account (API Key)

Installation

1. Clone the repository

   git clone https://github.com/dankritz/jira-sprint-analyzer.git
   cd jira-sprint-analyzer

2. Install dependencies

   npm install

3. Configure Environment Create a .env file in the root directory (or rename .env.example).

   cp .env.example .env

   Fill in your credentials:

   # Your Jira Instance URL (e.g., https://mycompany.atlassian.net)
   JIRA_HOST=your-domain.atlassian.net
   
   # The email address you use to log in to Jira
   JIRA_EMAIL=user@example.com
   
   # Generate at: https://id.atlassian.com/manage-profile/security/api-tokens
   JIRA_API_TOKEN=your-jira-api-token
   
   # Find this ID in your browser URL when viewing your board
   JIRA_BOARD_ID=123
   
   # Get Key at: https://openrouter.ai/keys
   OPENROUTER_API_KEY=sk-or-your-key
   
   # Default Model (Locked)
   DEFAULT_MODEL=openai/gpt-5.2

▶️ Running the App

Start both the backend server and frontend client with a single command:

npm start

• Frontend: http://localhost:5173
• Backend: http://localhost:3001

🛠️ Built With

• Frontend: React, Vite, Lucide
• Backend: Express.js
• AI: OpenRouter API
• PDF: Puppeteer

📝 License

This project is licensed under the MIT License.