| name | jira-cli |
| description | Use this skill when the user wants to create, search, edit, assign, or manage Jira issues, epics, sprints, and projects from the command line. |
Jira CLI Plugin
Feature-rich Jira command-line tool for managing issues, epics, sprints, and projects. Non-interactive mode with --no-input and JSON output with --raw.
Prerequisites
Requires Jira configuration via jira init:
- Cloud: JIRA_API_TOKEN environment variable
- Server: Password or Personal Access Token
jira init
Commands
Version
jira self version — Print versionjira self me — Get current user
Issues
jira issue list [--jql "query"] [-s "status"] [-y priority] — List issues (JSON)jira issue view ISSUE-1 — View single issue (JSON)jira issue create -t Task -s "Title" -y High -b "Description" — Create issuejira issue edit ISSUE-1 -s "New title" — Edit issuejira issue assign ISSUE-1 "User Name" — Assign issue
Epics & Sprints
jira epic list PROJ — List epics in projectjira sprint list --board 1 --state active — List active sprints
Projects
jira project list — List all projects
Full Access
jira _ _ — Passthrough for any jira command (epic add, sprint start, release, board, etc.)
Usage Examples
- "Show all high priority issues assigned to me"
- "Create a new Jira task with high priority"
- "List issues in the To Do status"
- "View details of PROJ-123"
- "Assign PROJ-456 to John"
- "List all epics in the PROJ project"
- "Search issues with JQL: summary ~ cli"
Installation
brew install jira-cli
Then configure:
jira init
export JIRA_API_TOKEN="your-token"
Key Features
- Non-interactive mode:
--no-input for agent-friendly scripting
- JSON output:
--raw flag returns structured data
- CSV output:
--csv flag for spreadsheet-friendly data
- JQL support: Raw JQL queries via
--jql / -q
- Rich filtering: Filter by status, priority, labels, assignee, project, created date
- Full lifecycle: Create, edit, assign, transition, watch, comment, attach
- Epic & Sprint management: Track epics and sprints across projects
