jira-cli

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

1. Install jira-cli: brew install ankitpokhrel/jira-cli/jira-cli (macOS) or download from releases
2. Set API token: export JIRA_API_TOKEN="your-token"
3. 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