jira-cli

xdg's avatarfrom xdg

Manage Jira issues via command line - read issues, query by filters, create/update issues, add comments, and close issues after work completion.

⭐2stars🔀0forks📁View on GitHub🕐Updated Nov 23, 2025⬇️1downloads

When & Why to Use This Skill

The jira-cli skill empowers users to manage Jira issues efficiently through a command-line interface. It streamlines project management by allowing for rapid issue querying, creation, updates, and status transitions directly within the terminal, making it an essential tool for developers and agile teams looking to integrate task tracking into their technical workflows.

Use Cases

  • Scenario 1: Streamlining development workflows by viewing issue details and requirements directly in the terminal while coding, eliminating the need to switch to a web browser.
  • Scenario 2: Automating repetitive project management tasks, such as adding commit-related comments to Jira issues or linking development progress to specific tickets.
  • Scenario 3: Efficiently managing task lifecycles by assigning issues to yourself and updating their status (e.g., moving to 'Done') immediately upon completion of work.
  • Scenario 4: Performing rapid queries and filtering issues by status, priority, or assignee to generate quick progress reports or identify blockers without navigating the Jira UI.
namejira-cli
descriptionManage Jira issues via command line - read issues, query by filters, create/update issues, add comments, and close issues after work completion.

jira-cli: Command-Line Jira Management

Use jira-cli when interacting with Jira. Assume jira-cli already installed/configured.

Project flag: Always use -p PROJ to specify project explicitly (don't rely on defaults)

When to Use

Use for: Reading issues, querying (status/priority/assignee filters), creating/updating issues, adding comments, closing after work complete

Ask user for web UI: Attachments/images, visual board operations (can't do from CLI)

Core Pattern: Work on Issue

jira issue view -p PROJ PROJ-123              # Read requirements
jira issue assign PROJ-123 $(jira me)         # Assign to user
# ... implement ...
jira issue comment add PROJ-123 "Fixed in $(git rev-parse --short HEAD)"
jira issue move PROJ-123 "Done"               # Close when complete

Efficient Extraction

Extract only needed fields to minimize context usage:

# Get specific fields only
jira issue view -p PROJ PROJ-123 --raw | jq -r '.fields.status.name'

# List keys for iteration
jira issue list -p PROJ --plain --no-headers --columns KEY

When to Load Detailed Guide

Load jira-cli reference guide for:

  • Command syntax and flags
  • Query patterns and JQL filtering
  • Output format options
  • User intent → command mapping
  • Git integration patterns