Labsco
Aarul5 logo

Jira-pilot

★ 4

from Aarul5

About AI-powered Jira CLI and MCP server for humans and agents manage issues, sprints, boards with interactive wizards, multi-provider AI

🔥🔥🔥🔥✓ VerifiedFreeQuick setup
#email#automation#git#security#project-mgmt

Jira Pilot ✈️

MCP Badge

The AI-Powered Jira CLI and MCP Server for Humans and Agents.

jira-pilot is a next-generation CLI that combines traditional developer tools with modern AI capabilities.

  • For Humans: A beautiful, interactive CLI to manage issues, sprints, boards, and code. Now with AI Code Reviews, Epic Planning, Daily Standups, and Natural Language JQL.
  • For Agents: A fully compliant Model Context Protocol (MCP) server with 14 tools that lets AI assistants (like Claude Desktop, Cursor, or Gemini) interact with your Jira instance safely.

Features at a Glance

👤 Human-Centric Features

FeatureDescription
Issue ManagementCreate, edit, view, list, transition, assign, and comment on issues
Work & TimeNew: Log work (2h 30m), manage sprints (start/complete), and subtasks
Developer ToolsNew: Open PRs, save local filters, git branch integration
Power ToolsNew: Bulk assign, bulk label, bulk transition matching JQL
Advanced DataNew: Upload attachments, manage custom fields by alias
AI CopilotSummarize, draft descriptions, suggest actions, review code, plan epics, standup reports
Interactive WizardsStep-by-step prompts with enquirer — no flags required
Rich VisualizationDashboard overview, spinners, and formatted output
ExportOutput to JSON or Markdown files, pipeable JSON output

🤖 Agentic Features (MCP)

FeatureDescription
14 MCP Toolslist_issues, get_issue, create_issue, update_issue, transition_issue, assign_issue, add_comment, add_worklog, create_subtask, add_attachment, search_users, myself, list_projects, list_sprints
LLM-OptimizedClean, structured JSON responses for efficient token usage
Stdio TransportStandard MCP stdio server — works with any MCP client

✨ Interactive Experience

Jira Pilot is designed to be fully interactive. You don't need to remember complex flags.

Just run the command, and we'll guide you:

  1. Selection: Use arrow keys ↑ ↓ to navigate lists (Projects, Issue Types, Priorities).
  2. Filtering: Start typing to filter long lists (e.g., finding a specific assignee).
  3. Wizards: Complex flows like creating an issue are broken down into simple steps.
  4. Confirmation: Destructive actions prompt for confirmation (y/N).

Example:

jira issue create
? Select Project: PROJ - My Project
? Select Issue Type: Bug
? Summary: Login page crashes
? Priority: High
? Assignee: Me

🖥️ Text User Interface (TUI)

Experience Jira in a persistent, interactive terminal interface.

jira tui

Key Features:

  • Dashboard: Overview of your assigned work.
  • Issue Navigator: Browse, filter, and view issues.
  • Kanban Boards: Visualize and manage work on Agile boards.
  • Interactive: Use arrow keys to navigate rows and columns.

Navigation Shortcuts:

  • ← / → : Switch Tabs (Dashboard, Issues, Boards) or Board Columns
  • ↑ / ↓ : Navigate Lists
  • Enter : Select / View Details
  • Esc / b : Back
  • q : Quit

📊 My Dashboard

Start your day with a high-level overview of what's on your plate.

jira dashboard

What you'll see:

  • 👋 Welcome Message: Personalized greeting.
  • 🔥 High Priority: Issues assigned to you that need immediate attention.
  • 📋 Recent Activity: Your recently viewed or updated issues.
  • 🚀 Sprint Status: (If applicable) Active sprint progress.

🧠 Using with AI Agents (MCP)

jira-pilot implements the Model Context Protocol (MCP), making it plug-and-play for AI assistants.

Starting the MCP Server

jira mcp

Available MCP Tools (14)

Everything you need to build a fully autonomous Jira agent:

  1. jira_list_issues: Search via JQL (supports limit)
  2. jira_get_issue: Get full details
  3. jira_create_issue: Create new issue (ADF support)
  4. jira_update_issue: Update summary, desc, priority, assignee
  5. jira_transition_issue: Change status
  6. jira_assign_issue: Change assignee
  7. jira_add_comment: Add comment
  8. jira_add_worklog: Log time
  9. jira_create_subtask: Create subtask
  10. jira_add_attachment: Upload file (absolute path)
  11. jira_search_users: Search for users
  12. jira_myself: Get current user details
  13. jira_list_projects: List accessible projects
  14. jira_list_sprints: List sprints for a board

Agent Configuration (Claude Desktop)

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["-y", "jira-pilot", "mcp"]
    }
  }
}

VS Code / Cursor Configuration

Add to your .vscode/mcp.json or equivalent:

{
  "servers": {
    "jira-pilot": {
      "command": "jira",
      "args": ["mcp"]
    }
  }
}

📝 Prompts

Pre-defined templates to help LLMs interact with Jira effectively.

PromptArgumentsDescription
jira-assistNoneSystem prompt that teaches the LLM how to use Jira Pilot tools best.
jira-summarize-issueissueKeyFetches an issue and instructs the LLM to provide a concise summary.

📦 Resources

Direct access to Jira data as context.

URIDescription
jira://myselfDetails of the currently authenticated user (excluding sensitive PII).
jira://projectsList of all accessible Jira projects.

🔍 Verification

You can verify the MCP server implementation using the official inspector:

# If running fro source
npx @modelcontextprotocol/inspector node dist/bin/jira.js mcp

# If installed globally (or via npx)
npx @modelcontextprotocol/inspector npx -y jira-pilot mcp

📦 CLI Command Reference

Run jira help or jira [command] help to see all options.

jira [command]

Commands:
  config           Configure Jira credentials & profiles
  issue            Manage Jira issues
  project          Manage Jira projects
  board            Manage Jira boards
  sprint           Manage Sprints
  bulk             Bulk operations on Jira issues
  dashboard        Show a quick overview of your Jira activity
  git              Git integration for Jira
  ai               AI Helper commands
  mcp              Start MCP Agent Server (Stdio)

🤝 Contributing

We welcome contributions! Please see CONTRIBUTING.md for details on how to submit a pull request and set up your development environment.

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

🛡️ Security

If you discover a security vulnerability within this project, please check SECURITY.md for our reporting policy.

📄 License

ISC