🚀 AI Workflow Utils

The Ultimate AI-Powered Development Workflow Automation Platform

Streamline your development process with intelligent Jira ticket creation, AI-powered code reviews & pull request creation, and seamless attachment management

🎉 NEW IN v1.x.x - Game-Changing Features!

🎯 Feature #1: AI-Powered Jira Ticket Creation

Create professional Jira tickets (Tasks, Bugs, Stories) using AI with multiple provider support:

• 🤖 OpenAI Compatible APIs: GPT-4, Claude, and other cloud providers
• 🏠 Local AI with Ollama LLaVA: Complete privacy with local image analysis
• 📸 Smart Image Analysis: Upload screenshots and get detailed issue descriptions
• ⚡ Real-time Streaming: Watch AI generate content live
• 🎨 Professional Templates: Auto-formatted with proper sections and acceptance criteria
• 🔗 Direct Jira Integration: Creates tickets instantly with your access token

🚀 Feature #2: AI-Powered Pull Request Creation

Revolutionary AI-powered pull request creation for Atlassian Bitbucket:

• 🤖 Intelligent PR Generation: AI analyzes commit messages to create professional PR titles and descriptions
• 📝 Smart Commit Analysis: Automatically determines PR type (feat/fix/chore) based on commit patterns
• ⚡ Real-time Streaming: Watch AI generate PR content live with streaming updates
• 🔄 Multi-Model Support: Uses Ollama for local AI processing with privacy
• ✏️ Editable Previews: Review and edit AI-generated content before creating the PR
• 🎯 Ticket Integration: Automatically includes ticket numbers in PR titles
• 💾 Smart Persistence: Remembers project and repository settings for faster workflow

🔍 Feature #3: GitStash PR AI Review

Revolutionary AI-powered pull request reviews for Atlassian Bitbucket:

• 🧠 Intelligent Code Analysis: AI reviews your code changes
• 💡 Smart Suggestions: Get actionable improvement recommendations
• 🔄 Multi-Model Support: OpenAI Compatible APIs + Ollama for flexibility
• 📝 Automated Comments: AI adds review comments directly to your PRs
• ⚡ Coming Soon: Direct comment integration (currently in development)

📎 Feature #4: Simple Jira Attachment Management

Effortless file management for your Jira tickets:

• 📁 Drag & Drop Interface: Simple file uploads
• 🎥 Video Conversion: Automatic .mov to .mp4 conversion
• 📸 Image Optimization: Smart image processing
• 🔗 Direct Integration: Seamless attachment to existing tickets

Here’s a cleaned-up and renumbered version of your “Quick Start Guide” section for the README. All step numbers are sequential, and optional sub-steps are clearly labeled. Copy-paste this to replace your existing section:

🚀 Quick Start Guide

Step 1: Recommended - Ollama Setup (For Local AI)

# Install Ollama (if you want local AI processing)
# macOS
brew install ollama

# Linux
curl -fsSL https://ollama.com/install.sh | sh

# Windows - Download from https://ollama.com/

# Download the LLaVA model for image analysis
ollama pull llava

# Start Ollama service
ollama serve

Then configure Ollama as your AI provider in the web interface.

Step 2: Installation

npm install -g ai-workflow-utils

Step 3: Launch the Application

# Start the application directly
ai-workflow-utils

The application will start immediately and be available at http://localhost:3000

Step 4: (Optional) Install as Startup Service

For production use or to run automatically on system boot:

ai-workflow-utils startup install

The service will now start automatically on boot. Access at http://localhost:3000

Startup Service Management:

ai-workflow-utils startup status    # Check service status
ai-workflow-utils startup start     # Start the service
ai-workflow-utils startup stop      # Stop the service
ai-workflow-utils startup uninstall # Remove startup service

Supported Platforms:

• macOS: Uses LaunchAgents (user-level service)
• Windows: Uses Windows Service Manager
• Linux: Uses systemd

For detailed startup service documentation, see STARTUP.md

Step 5: Configure Using the Settings Page

All configuration is managed through the web-based settings page:

• Visit http://localhost:3000/settings/environment
• Configure your AI provider (Anthropic Claude, OpenAI GPT, Google Gemini, Ollama)
• Set up Jira integration (URL, API token)
• Configure repository provider (Bitbucket)
• Set up issue tracking (Jira, etc.)

All changes are saved to ~/.ai-workflow-utils/environment.json and persist across upgrades.

No manual .env setup required!

Step 6: (Optional) PWA Installation (Progressive Web App)

AI Workflow Utils is a fully-featured PWA! Install it as a native app for the best experience:

🖥️ Desktop Installation:

1. Open http://localhost:3000 in Chrome, Edge
2. Look for the "Install" button in the address bar
3. Click "Install" to add AI Workflow Utils to your desktop
4. Launch directly from your desktop/dock - no browser needed!

✨ PWA Benefits: - 🚀 Faster Loading: Cached resources for instant startup - 📱 Native Feel: Works like a desktop - 🔄 Auto Updates: Always get the latest features - 💾 Offline Ready: Basic functionality works without internet - 🎯 Focused Experience: No browser distractions

# Interactive setup wizard
ai-workflow-setup

# Check configuration
ai-workflow-utils --config

# Test connections
ai-workflow-utils --test

# Start in development mode
ai-workflow-utils --dev

# Enable debug logging
ai-workflow-utils --debug

# Specify custom port
ai-workflow-utils --port 8080

# Check Ollama status
ai-workflow-utils --ollama-status

# Download recommended models
ai-workflow-utils --setup-ollama

# List available models
ollama list

// Automatic fallback order:
1. OpenAI Compatible API (Primary)
2. Ollama LLaVA (Local fallback)
3. Error handling with user notification

# For different OpenAI-compatible providers:
OPENAI_COMPATIBLE_MODEL=gpt-4-vision-preview    # OpenAI
OPENAI_COMPATIBLE_MODEL=claude-3-sonnet-20240229 # Anthropic
OPENAI_COMPATIBLE_MODEL=llama-2-70b-chat        # Custom API

# For Ollama local models:
OLLAMA_MODEL=llava:13b      # Larger model for better quality
OLLAMA_MODEL=llava:7b       # Faster, smaller model
OLLAMA_MODEL=codellama:7b   # Code-focused model

# Streaming configuration
STREAM_CHUNK_SIZE=1024
STREAM_TIMEOUT=60000

# Rate limiting
API_RATE_LIMIT=100
API_RATE_WINDOW=900000

# File upload limits
MAX_FILE_SIZE=50MB
ALLOWED_FILE_TYPES=jpg,jpeg,png,gif,mp4,mov,pdf,doc,docx

# Build the application
npm run build

# Create Docker image
docker build -t ai-workflow-utils .

# Run container
docker run -p 3000:3000 --env-file .env ai-workflow-utils

# Install PM2
npm install -g pm2

# Start application
pm2 start ecosystem.config.js

# Monitor
pm2 monit

# View logs
pm2 logs ai-workflow-utils

server {
    listen 80;
    server_name your-domain.com;
    
    location / {
        proxy_pass http://localhost:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_cache_bypass $http_upgrade;
    }
}

# Logging levels: error, warn, info, debug
LOG_LEVEL=info

# Log file rotation
LOG_MAX_SIZE=10MB
LOG_MAX_FILES=5

# Enable request logging
LOG_REQUESTS=true

# Clone the repository
git clone https://github.com/anuragarwalkar/ai-workflow-utils.git
cd ai-workflow-utils

# Install dependencies
npm install

# Set up environment
cp .env.example .env
cp ui/.env.example ui/.env

# Start development server
npm run dev

ai-workflow-utils/
├── bin/                 # CLI scripts
├── server/             # Backend (Node.js + Express)
├── ui/                 # Frontend (React + Redux)
├── dist/               # Built files
└── docs/               # Documentation

POST /api/jira/preview
Content-Type: application/json

{
  "prompt": "Login button not working",
  "images": ["base64-encoded-image"],
  "issueType": "Bug"
}

POST /api/pr/stream-preview
Content-Type: application/json

{
  "projectKey": "PROJ",
  "repoSlug": "my-repo",
  "ticketNumber": "PROJ-123",
  "branchName": "feature/my-branch"
}

# Returns Server-Sent Events stream with:
# - status updates
# - title_chunk events (streaming title generation)
# - title_complete event (final title)
# - description_chunk events (streaming description generation)
# - description_complete event (final description)
# - complete event (final preview data)

POST /api/pr/create
Content-Type: application/json

{
  "projectKey": "PROJ",
  "repoSlug": "my-repo",
  "ticketNumber": "PROJ-123",
  "branchName": "feature/my-branch",
  "customTitle": "feat(PROJ-123): Add user authentication",
  "customDescription": "## Summary\nAdded user authentication feature\n\n## Changes Made\n- Added login component\n- Implemented JWT tokens"
}

POST /api/pr/review
Content-Type: application/json

{
  "repoUrl": "https://bitbucket.company.com/projects/PROJ/repos/repo",
  "pullRequestId": "123",
  "reviewType": "security"
}

POST /api/jira/upload
Content-Type: multipart/form-data

file: [binary-data]
issueKey: "PROJ-123"

# Check if Ollama is running
ollama list

# Start Ollama service
ollama serve

# Pull required model
ollama pull llava

# Test Jira connection
curl -H "Authorization: Bearer YOUR_TOKEN" \
     https://your-company.atlassian.net/rest/api/2/myself

# Use different port
ai-workflow-utils --port 8080

# Or kill existing process
lsof -ti:3000 | xargs kill -9

# Enable detailed logging
ai-workflow-utils --debug

# Check logs
tail -f logs/app.log

📞 Support

Getting Help

• 📖 Documentation: GitHub Wiki
• 🐛 Bug Reports: GitHub Issues
• 💬 Discussions: GitHub Discussions
• 📧 Email: anurag.arwalkar@gmail.com

Community

• ⭐ Star us on GitHub: Show your support!
• 🔄 Share: Help others discover this tool
• 🤝 Contribute: Join our growing community

📈 Roadmap

Coming Soon

• 🔗 Direct PR Comments: AI comments directly in Bitbucket
• 🔄 Workflow Automation: Custom automation workflows
• 📊 Analytics Dashboard: Usage insights and metrics
• 🔌 Plugin System: Extensible architecture
• 🌐 Multi-language Support: Internationalization

Future Features

• 🤖 Advanced AI Agents: Specialized AI for different tasks
• 🔗 More Integrations: GitHub, GitLab, Azure DevOps
• 📱 Mobile App: Native mobile applications
• 🎯 Smart Routing: Intelligent task assignment

📄 License

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

🎖️ Acknowledgments

Special thanks to the amazing open-source community and the following technologies that make this project possible:

• 🤖 OpenAI & Anthropic: For providing excellent AI APIs
• 🏠 Ollama: For enabling local AI processing with privacy
• 🎯 Atlassian: For robust Jira and Bitbucket APIs
• ⚛️ React & Redux: For building beautiful, responsive UIs
• 🚀 Node.js & Express: For reliable backend infrastructure
• 🎨 Material-UI: For professional design components

🌟 Why Choose AI Workflow Utils?

🚀 Productivity Boost

• 10x Faster: Create professional Jira tickets in seconds
• AI-Powered: Let AI handle the heavy lifting
• Streamlined: One tool for all your workflow needs

🔒 Privacy First

• Local Processing: Use Ollama for complete data privacy
• No Vendor Lock-in: Multiple AI provider support
• Your Data: Stays on your infrastructure

🛠️ Developer Friendly

• Easy Setup: Get started in minutes
• CLI Tools: Powerful command-line interface
• Extensible: Open architecture for customization

💼 Enterprise Ready

• Scalable: Handles teams of any size
• Secure: Enterprise-grade security features
• Reliable: Battle-tested in production environments

npm install -g ai-workflow-utils