Interact with Jira from the command line to create, list, view, edit, and transition issues, manage sprints and epics, and perform common Jira workflows. Use…
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
don't have the plugin yet? install it then click "run inline in claude" again.