| name | jira-cli |
| description | Interactive CLI for Atlassian Jira issue, epic, and sprint management. |
| disable-model-invocation | true |
Jira CLI
Interactive command-line tool for Atlassian Jira that minimizes reliance on the web interface while maintaining essential functionality for daily Jira operations.
Overview
JiraCLI (jira-cli) is a command line tool for managing Jira issues, epics, and sprints. Supports both Jira Cloud and on-premise installations with multiple authentication methods.
For AI use, always add --plain flag to get plain text output suitable for parsing.
When to Use This Skill
Use this skill when:
- Managing Jira issues from the command line
- Creating, editing, or viewing Jira tickets
- Working with epics and sprints
- Automating Jira workflows
- Users mention "jira", "ticket", "issue", "epic", or "sprint"
- Writing scripts for Jira automation
Essential Commands
jira issue list --plain
jira issue view ISSUE-1 --plain
jira issue create -tBug -s"Bug title" -yHigh -b"Description"
jira issue assign ISSUE-1 $(jira me)
jira issue move ISSUE-1 "In Progress"
jira issue comment add ISSUE-1 --comment "My comment"
jira issue worklog add ISSUE-1 "2h" --comment "Implementation work"
How to Use This Skill
For detailed command reference and examples, load the appropriate reference file:
1. Comprehensive Commands Reference
Load: references/commands.md
Use this file when you need:
- Detailed command syntax and options
- All available flags and parameters
- Issue management operations (list, create, edit, assign, move, view, link, clone, delete)
- Epic management (list, create, add/remove issues)
- Sprint management (list, add issues)
- Release management
- Output format options
- Non-interactive command patterns
2. Common Workflow Examples
Load: references/workflows.md
Use this file when you need:
- Daily standup preparation workflows
- Sprint planning commands
- Code review workflow integration
- Bug triage procedures
- Team collaboration patterns
- Best practices for different scenarios
3. Scripting and Automation
Load: references/scripting.md
Use this file when you need:
- Bash automation scripts
- Data extraction and reporting
- Integration with CI/CD pipelines
- Metrics and analytics examples
- Bulk operations
Quick Reference
Powerful List Filters
jira issue list --plain -a$(jira me) -yHigh -s"To Do" --created -7d -lbackend
jira issue list --plain -s~Done --created-before -24w
jira issue list --plain -yHigh,Critical -s"In Progress" -lbug
jira issue list --plain -w
jira issue list --plain -ax --created week
jira issue list --plain --created -1h
jira issue list --plain --history
Sprint Management
jira sprint list --plain --current
jira sprint list --plain --current -a$(jira me)
jira sprint list --plain --prev
jira sprint list --plain --next
jira sprint list --plain --state future,active
jira sprint list --plain SPRINT_ID
jira sprint add SPRINT_ID ISSUE-1 ISSUE-2
Epic Management
jira epic list --plain --table
jira epic list --plain KEY-1
jira epic list --plain KEY-1 -ax -yHigh
jira epic add EPIC-KEY ISSUE-1 ISSUE-2
jira epic remove ISSUE-1 ISSUE-2
Useful Scripts
sprints=$(jira sprint list --table --plain --columns id,name --no-headers)
echo "${sprints}" | while read -r id name; do
count=$(jira sprint list "${id}" --plain --no-headers 2>/dev/null | wc -l)
printf "%s: %d\n" "${name}" "${count}"
done
jira issue list --plain --created -1d
jira issue list --plain -a$(jira me) -tBug -yHigh
jira issue list --plain --created week
jira issue list --plain --created month
jira issue list --plain --created -7d
jira issue list --plain --updated -30m
Resources