SKILL.md

Jira CLI

Interact with Atlassian Jira from the command line using jira-cli.

When to Use

User asks to create, view, edit, or search Jira issues/tickets

User needs to transition issues through workflow states (To Do → In Progress → Done)

User wants to manage sprints, epics, or boards

User needs to assign issues, add comments, or log work time

User asks about their current tasks or sprint progress

Prerequisites

Install jira-cli: brew install ankitpokhrel/jira-cli/jira-cli (macOS) or download from releases

Set API token: export JIRA_API_TOKEN="your-token"

Initialize: jira init and follow prompts

Issue Commands

List Issues

# List issues in current project

jira issue list

# List my assigned issues

jira issue list -a$(jira me)

# List issues by status

jira issue list -s"In Progress"

# List high priority issues

jira issue list -yHigh

# List issues with multiple filters

jira issue list -a$(jira me) -s"To Do" -yHigh --created week

# List issues with raw JQL

jira issue list -q "project = PROJ AND status = 'In Progress'"

# Plain text output for scripting

jira issue list --plain --columns key,summary,status --no-headers

Create Issues

# Interactive issue creation

jira issue create

# Create with all options specified

jira issue create -tBug -s"Login button not working" -b"Description here" -yHigh --no-input

# Create a story

jira issue create -tStory -s"Add user authentication" -yMedium

# Create with labels and components

jira issue create -tTask -s"Update dependencies" -lmaintenance -l"tech-debt" -Cbackend

# Create and assign to self

jira issue create -tBug -s"Fix crash on startup" -a$(jira me) --no-input

View Issues

# View issue details

jira issue view ISSUE-123

# View with comments

jira issue view ISSUE-123 --comments 10

# View in plain text

jira issue view ISSUE-123 --plain

# Open issue in browser

jira open ISSUE-123

Edit Issues

# Edit summary

jira issue edit ISSUE-123 -s"Updated summary"

# Edit description

jira issue edit ISSUE-123 -b"New description"

# Edit priority

jira issue edit ISSUE-123 -yHigh

# Add labels

jira issue edit ISSUE-123 -lnew-label

Transition Issues

# Move issue to a new status

jira issue move ISSUE-123 "In Progress"

# Move with comment

jira issue move ISSUE-123 "Done" --comment "Completed the task"

# Move and set resolution

jira issue move ISSUE-123 "Done" -RFixed

Assign Issues

# Assign to self

jira issue assign ISSUE-123 $(jira me)

# Assign to specific user

jira issue assign ISSUE-123 username

# Unassign

jira issue assign ISSUE-123 x

Comments

# Add a comment

jira issue comment add ISSUE-123 "This is my comment"

# Add comment from editor

jira issue comment add ISSUE-123

Work Logging

# Log time

jira issue worklog add ISSUE-123 "2h 30m"

# Log time with comment

jira issue worklog add ISSUE-123 "1d 4h" --comment "Completed feature implementation" --no-input

Link & Clone Issues

# Link two issues

jira issue link ISSUE-123 ISSUE-456 Blocks

# Unlink issues

jira issue unlink ISSUE-123 ISSUE-456

# Clone an issue

jira issue clone ISSUE-123 -s"Cloned: New summary"

# Delete an issue

jira issue delete ISSUE-123

Epic Commands

# List epics

jira epic list

# List epics in table format

jira epic list --table

# Create an epic

jira epic create -n"Q1 Features" -s"Epic summary" -b"Epic description"

# Add issues to epic

jira epic add EPIC-1 ISSUE-123 ISSUE-456

# Remove issues from epic

jira epic remove ISSUE-123 ISSUE-456

Sprint Commands

# List sprints

jira sprint list

# List current/active sprint

jira sprint list --current

# List my issues in current sprint

jira sprint list --current -a$(jira me)

# Add issues to sprint

jira sprint add SPRINT_ID ISSUE-123 ISSUE-456

Project & Board Commands

# List projects

jira project list

# List boards

jira board list

# List releases/versions

jira release list

# Open project in browser

jira open

Utility Commands

# Get current username

jira me

# Show help

jira --help

jira issue --help

# Setup shell completion

jira completion bash  # or zsh, fish, powershell

Common Flags

Flag

Description

--plain

Plain text output (no interactive UI)

--raw

Raw JSON output

--csv

CSV output

--no-input

Skip interactive prompts

-t, --type

Issue type (Bug, Story, Task, Epic)

-s, --summary

Issue summary/title

-b, --body

Issue description

-y, --priority

Priority (Highest, High, Medium, Low, Lowest)

-l, --label

Labels (repeatable)

-a, --assignee

Assignee username

-r, --reporter

Reporter username

-C, --component

Component name

-P, --parent

Parent issue/epic key

-q, --jql

Raw JQL query

--created

Filter by creation date (-7d, week, month)

--order-by

Sort field

--reverse

Reverse sort order

Common Workflows

Start Working on an Issue

# Assign to self and move to In Progress

jira issue assign ISSUE-123 $(jira me)

jira issue move ISSUE-123 "In Progress"

Complete an Issue

# Log work and close

jira issue worklog add ISSUE-123 "4h" --no-input

jira issue move ISSUE-123 "Done" --comment "Completed" -RFixed

Daily Standup Review

# View my current sprint tasks

jira sprint list --current -a$(jira me)

Create and Track a Bug

# Create bug

jira issue create -tBug -s"App crashes on login" -yHigh -lbug --no-input

# Note the returned issue key, then assign

jira issue assign BUG-123 $(jira me)

jira issue move BUG-123 "In Progress"

Output Examples

Command

Use Case

jira issue list --plain

Script-friendly output

jira issue list --raw

JSON for parsing

jira issue list --csv

Export to spreadsheet

Limitations

Requires prior jira init configuration

Some features may vary between Jira Cloud and Server

Complex custom fields may require --custom flag with field IDs

Rate limits apply based on Jira instance configuration

jira-cli