What is acli used for in Jira operations?

Acli provides common Atlassian CLI commands to view, search, comment, transition, create, and list Jira items from the command line.

Do I need authentication for acli?

Yes. Install and login with acli jira auth login --web and verify status with acli jira auth status.

How can I get machine-readable output?

Use --json or --fields options to control the output for scripting and automation.

acli

npx machina-cli add skill nmoinvaz/speedy-gonzales/acli --openclaw

Files (1)

SKILL.md

2.6 KB

Atlassian CLI (acli) Quick Reference

Common acli commands for Jira operations used across this project's workflows.

Prerequisites

acli must be installed and authenticated: acli jira auth login --web
Check auth status: acli jira auth status

View Issue Details

acli jira workitem view PROJ-123

With all fields (description, comments, etc.):

acli jira workitem view PROJ-123 --fields "*all"

JSON output for parsing:

acli jira workitem view PROJ-123 --json

Specific fields only:

acli jira workitem view PROJ-123 --fields "summary,status,priority,description,comment"

Search Issues with JQL

acli jira workitem search --jql 'summary ~ "CVE-2024-1234" AND summary ~ "repo-name"' --json

Search by text across all fields:

acli jira workitem search --jql 'text ~ "search terms" AND key != PROJ-123' --json

Search by component:

acli jira workitem search --jql 'component = "my-component" AND key != PROJ-123' --json

Search recently resolved issues:

acli jira workitem search --jql 'text ~ "search terms" AND status in (Resolved, Done, Closed) AND resolved >= -30d' --json

Limit results and select fields:

acli jira workitem search --jql 'project = PROJ' --fields "key,summary,status" --limit 20 --json

Add Comment to Issue

acli jira workitem comment create --key PROJ-123 --body "Comment text here"

Multi-line comment from a file:

acli jira workitem comment create --key PROJ-123 --body-file comment.txt

List Comments on Issue

acli jira workitem view PROJ-123 --fields "comment" --json

Transition Issue Status

First check available transitions:

acli jira workitem view PROJ-123 --fields "status" --json

Then transition:

acli jira workitem transition --key PROJ-123 --status "Done"
acli jira workitem transition --key PROJ-123 --status "In Progress"
acli jira workitem transition --key PROJ-123 --status "Resolved"

Create Issue

acli jira workitem create --project PROJ --type Bug --summary "Bug title" --description "Description"

With assignee and labels:

acli jira workitem create --project PROJ --type Task --summary "Title" \
  --assignee "user@example.com" --label "bug,triage"

Edit Issue

acli jira workitem edit --key PROJ-123 --summary "Updated summary"
acli jira workitem edit --key PROJ-123 --assignee "@me"

List Projects

acli jira project list

Source

git clone https://github.com/nmoinvaz/speedy-gonzales/blob/main/skills/acli/SKILL.mdView on GitHub

Overview

Acli is the Atlassian CLI for Jira operations used in this project’s workflows. It enables fast, scriptable interactions with Jira—from viewing issue details to creating, editing, and transitioning issues, and listing projects. It requires installation and authentication via acli jira auth login --web.

How This Skill Works

Invoke CLI commands under the acli jira namespace, such as workitem view, workitem search, workitem comment create, workitem transition, workitem create, workitem edit, and project list. Output can be JSON (--json) or field-limited (--fields) for automation. Before use, authenticate with acli jira auth login --web and verify status.

When to Use It

Quickly inspect an issue’s details before deciding on actions
Automate issue searches across Jira with JQL for dashboards or alerts
Add or review comments to keep context during triage
Transition issues to progress work or mark done after validation
Create or edit issues, or list projects for onboarding or audits

Quick Start

Step 1: Install and login with acli jira auth login --web; verify status with acli jira auth status
Step 2: View or search issues, e.g., acli jira workitem view PROJ-123 --fields "*all" --json or acli jira workitem search --jql 'project = PROJ' --json
Step 3: Perform actions such as adding a comment or creating an issue, e.g., acli jira workitem comment create --key PROJ-123 --body "Comment" or acli jira workitem create --project PROJ --type Bug --summary "Bug title" --description "Description"

Best Practices

Login and confirm auth status before running commands
Use --json for stable machine-readable output in scripts
Limit fields with --fields to reduce noise and improve parsing
Use --body-file for multi-line comments or descriptions
Preview transitions by viewing the issue status first

Example Use Cases

View PROJ-123 details with all fields: acli jira workitem view PROJ-123 --fields "*all"
Get JSON output for parsing: acli jira workitem view PROJ-123 --json
Search with JQL across terms and JSON: acli jira workitem search --jql 'summary ~ "CVE-2024-1234" AND summary ~ "repo-name"' --json
Add a comment to an issue: acli jira workitem comment create --key PROJ-123 --body "Comment text here"
Create an issue with assignee and labels: acli jira workitem create --project PROJ --type Task --summary "Title" --assignee "user@example.com" --label "bug,triage"

Frequently Asked Questions

Add this skill to your agents