PM-AI 📋

AI-powered Project Management Assistant for Jira - Create, manage, and track tasks with intelligent AI assistance.

Features ✨

• 🚀 Create Multiple Jira Issues from Natural Language
  • "Create a landing page for marketing agency" → Generates comprehensive task breakdown
• 📋 Project Planning & Breakdown
  • Automatically breaks down complex requests into concrete Jira tickets
• 💬 Comment Management
  • Add comments to existing issues
• ⏰ Deadline Management
  • Set and manage task deadlines
• 🔍 Issue Search & Analysis
  • Search and filter tasks using JQL
• 🎯 Intelligent Task Suggestion
  • Analyzes existing tasks to avoid duplicates

Installation

npm install
npm run build

Quick Start

npm run dev

Configuration

Run the onboard command to set up your project:

npm run dev onboard

This will guide you through:

• Selecting AI provider (OpenAI, Anthropic, etc.)
• Configuring Jira API credentials
• Setting up your default project

Usage Examples

Create a Landing Page

npm run dev
> Create a landing page for marketing agency

Add a Comment

npm run dev
> Add a comment "Please review this implementation"

Set a Deadline

npm run dev
> Set deadline for PROJ-123 as next Friday

Search Issues

npm run dev
> Search for tasks with priority High

CLI Commands

• pm-ai onboard - Configure your setup
• pm-ai - Interactive AI Project Manager (default)
• pm-ai <action> - Run specific action
  • create - Create new issues from natural language
  • comment - Add comments to existing issues
  • deadline - Set or manage deadlines
  • search - Search issues with JQL
  • list - List all project issues

Project Structure

pm-ai/
├── src/
│   ├── agent/          # Agent orchestration
│   ├── config/         # Configuration management
│   ├── core/           # Core logic
│   ├── mcp/            # Model Context Protocol
│   ├── providers/      # AI providers (OpenAI, etc.)
│   ├── session/        # Session management
│   ├── skills/         # Jira-specific skills
│   ├── tools/          # CLI tools
│   ├── tui/            # Terminal UI
│   └── ui/             # UI components
├── skills/             # Skills definitions
└── docs/               # Documentation

Skills

• task-creation - Analyzes requests and creates Jira issues
• task-planning - Breaks down complex requests into subtasks
• comment-management - Adds comments to issues
• deadline-management - Manages task deadlines

Environment Variables

Create .env file:

OPENAI_API_KEY=your_key_here
JIRA_API_KEY=your_jira_token
[email protected]
JIRA_PROJECT_KEY=PROJ

License

MIT