Jira Skill

Jira Skill

Interactive Jira command line tool for managing issues, epics, sprints, and more.

Setup

Installation

Install jira-cli:

# macOS (Homebrew)
brew install jira-cli

# Or download from releases
# https://github.com/​ankitpokhrel/​jira-cli/​releases

Configuration

1. Get a Jira API token for Jira Cloud: https://id.atlassian.com/manage-profile/security/api-tokens
2. Export the token:

export JIRA_API_TOKEN="your-api-token"

Add to your shell config (~/​.bashrc, ~/​.zshrc, etc.) to make it persistent.

1. Initialize jira-cli:

jira init

Follow the prompts to configure:

• Installation type (Cloud or Local)
• Base URL (e.g., https://yourcompany.atlassian.net)
• Email/​username
• Project key (optional, can be set per command)

For on-premise installations, you may need to set:

export JIRA_AUTH_TYPE="bearer"  # or "basic"

List Issues

# List recent issues (interactive)
jira issue list

# List issues created in last 7 days
jira issue list --created -7d

# List issues by status
jira issue list -s "To Do"
jira issue list -s "In Progress"
jira issue list -s "Done"

# List issues by priority
jira issue list --priority High

# List issues by assignee
jira issue list --assignee $(jira me)

# List issues by reporter
jira issue list --reporter $(jira me)

# List issues by label
jira issue list --label backend

# List issues by project
jira issue list --project PROJKEY

# Plain output (non-interactive)
jira issue list --plain

# JSON output (for parsing)
jira issue list --raw

# CSV output
jira issue list --csv

# Complex query: High priority, assigned to me, in To Do, created this month
jira issue list --priority High --assignee $(jira me) -s "To Do" --created month --label backend

Common Filters

View Issues

# View issue details in terminal
jira issue view ISSUE-123

# View without pager
jira issue view ISSUE-123 --no-pager

# View in browser
jira issue view ISSUE-123 --web

Create Issues

# Interactive creation (prompts for all fields)
jira issue create

# Create with summary only
jira issue create "Fix login bug"

# Create with type and summary
jira issue create --type Bug "Fix login bug"

# Create with all fields
jira issue create \
  --type Bug \
  --summary "Fix login bug" \
  --description "Users cannot login after update" \
  --priority High \
  --assignee "$(jira me)" \
  --label backend,auth \
  --project PROJKEY

Edit Issues

# Interactive edit (opens in editor)
jira issue edit ISSUE-123

# Edit summary
jira issue edit ISSUE-123 --summary "New summary"

# Edit description
jira issue edit ISSUE-123 --description "Updated description"

# Edit priority
jira issue edit ISSUE-123 --priority High

# Change assignee
jira issue edit ISSUE-123 --assignee "$(jira me)"

# Add labels
jira issue edit ISSUE-123 --label backend,bug

Transition Issues

# Interactive transition (choose from available transitions)
jira issue transition ISSUE-123

# Transition to specific status
jira issue transition ISSUE-123 "In Progress"
jira issue transition ISSUE-123 "Done"
jira issue transition ISSUE-123 "In Review"

Comments

# Add comment
jira issue comment add ISSUE-123 "This needs more testing"

# Add comment with markdown
jira issue comment add ISSUE-123 "**Note:** This is a priority issue."

# List comments
jira issue comment list ISSUE-123

# Edit comment
jira issue comment edit ISSUE-123 "Comment ID" "Updated comment"

# Delete comment
jira issue comment delete ISSUE-123 "Comment ID"

Worklog (Time Tracking)

# Add worklog
jira issue worklog add ISSUE-123 --time "2h" --message "Fixed the bug"

# Add worklog with specific time
jira issue worklog add ISSUE-123 --time "1d 2h 30m" --message "Implementation"

# List worklogs
jira issue worklog list ISSUE-123

# Delete worklog
jira issue worklog delete ISSUE-123 "Worklog ID"

Epics

# List epics
jira epic list

# List epics in plain mode
jira epic list --plain

# Create epic
jira epic create \
  --name "Authentication System" \
  --summary "Implement OAuth2 authentication" \
  --description "Add OAuth2 login flow"

# View epic details
jira epic view EPIC-123

# List issues in epic
jira epic list EPIC-123

# Add issues to epic
jira issue edit ISSUE-123 --epic EPIC-123

Sprints

# List sprints
jira sprint list

# List active sprint issues
jira sprint list --state active

# List issues in sprint
jira sprint list SPRINT-123

# Start sprint
jira sprint start SPRINT-123

# Close sprint
jira sprint close SPRINT-123

Projects

# List projects
jira project list

# View project details
jira project view PROJKEY

Current User

# Get current user info
jira me

# Get current user key
jira me --key

# Use in other commands
jira issue list --assignee "$(jira me)"

Search (JQL)

# Jira Query Language (JQL) search
jira issue list --query "project = PROJKEY AND status = 'In Progress'"

# Complex JQL
jira issue list --query 'project = PROJKEY AND assignee = currentUser() AND priority = High'

# JQL with date range
jira issue list --query "created >= -30d AND project = PROJKEY"

Interactive Navigation

In interactive mode:

• Arrow keys or j/​k/​h/​l - Navigate
• v - View issue details
• m - Transition issue
• ENTER - Open in browser
• c - Copy issue URL
• CTRL+k - Copy issue key
• CTRL+r or F5 - Refresh
• q / ESC / CTRL+c - Quit
• ? - Help

Multiple Projects

Use different config files:

# Use specific config
jira issue list --config ~/​jira-configs/​project1.yaml

# Or set environment variable
JIRA_CONFIG_FILE=~/​jira-configs/​project1.yaml jira issue list

Common Workflows

Get assigned issues for today

jira issue list --assignee "$(jira me)" -s "In Progress" --created -7d

Review backlog

jira issue list -s "To Do" --priority High

Get release notes (sprint summary)

jira sprint list --state closed
jira issue list --sprint SPRINT-123 -s Done

Start work on an issue

jira issue transition ISSUE-123 "In Progress"
jira issue view ISSUE-123

Complete an issue

jira issue transition ISSUE-123 "Done"
jira issue worklog add ISSUE-123 --time "1h" --message "Completed task"

Notes

• jira-cli supports both Jira Cloud and Jira Server/​Data Center
• For on-premise installations, you may need to use basic auth or PAT
• Time format: 1h (hour), 1d (day), 1w (week), 1m (month)
• Date filters: -7d (7 days ago), month (this month), week (this week)
• Always use quotes around status names with spaces: -s "In Progress"