Atlassian CLI - Jira Workflows
Quick reference for common Atlassian CLI Jira operations. Requires acli to be installed and authenticated.
Documentation: https://developer.atlassian.com/cloud/acli/reference/commands/jira/
Prerequisites
If acli is not installed or not authenticated, instruct the user to run:
acli auth login --web # Opens browser for OAuth
acli auth status # Verify authentication
Common JQL Patterns
Use these JQL queries with acli jira workitem search --jql "...":
Find tickets assigned to you
acli jira workitem search --jql "assignee = currentUser()" --paginate
Find tickets in a specific status
acli jira workitem search --jql 'status = "In Progress"'
acli jira workitem search --jql 'status IN ("To Do", "In Progress")'
Find tickets by project
acli jira workitem search --jql "project = PROJECTKEY"
Find tickets by reporter
acli jira workitem search --jql "reporter = currentUser()"
Find unassigned tickets
acli jira workitem search --jql "assignee = EMPTY"
Find recently updated tickets
acli jira workitem search --jql "updated >= -7d ORDER BY updated DESC"
Find open bugs in a project
acli jira workitem search --jql "project = PROJECTKEY AND type = Bug AND status != Closed"
Work Item Operations
View a ticket
acli jira workitem view PROJECTKEY-123
Create a new ticket
acli jira workitem create \
--project PROJECTKEY \
--type Task \
--title "My new task" \
--description "Task description"
Edit a ticket
acli jira workitem edit PROJECTKEY-123 --summary "Updated title"
Assign a ticket
acli jira workitem assign PROJECTKEY-123 --assignee user@example.com
Transition a ticket (change status)
acli jira workitem transition PROJECTKEY-123 --transition "In Progress"
Add a comment
acli jira workitem comment create --key PROJECTKEY-123 --body "This is my comment"
# Or from a file:
acli jira workitem comment create --key PROJECTKEY-123 --body-file comment.md
Delete a ticket
acli jira workitem delete PROJECTKEY-123
Board & Sprint Commands
acli jira board list-sprints --board BOARDKEY
acli jira sprint list-workitems --sprint SPRINTID
acli jira board search --name "My Board"
Tips
- JQL Documentation: https://www.atlassian.com/software/jira/guides/expand-jira/jira-query-language
- Use
--paginatewhen you expect many results (avoids truncation) - Use
--jsonfor programmatic processing,--csvfor spreadsheet export - Add
ORDER BY updated DESCto sort by most recent changes - Use
--webto open results in your browser - Combine multiple conditions:
AND,OR,NOT
For output formats, pagination, field customization, saved filters, and real-world query examples, see references/search-patterns.md.