jira-cli
/jira-cli
Reference guide for Atlassian CLI (acli) commands. Use when running acli commands for JQL queries, ticket transitions, comments, or workflow operations, or when the user asks about Jira CLI syntax.
- Author
- znorris ↗
- Repository
- claude-marketplace ↗
- Licence
- MIT
- Last repository change
- 14.07.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 14.07.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Reference guide for Atlassian CLI (acli) commands. Use when running acli commands for JQL queries, ticket transitions, comments, or workflow operations, or when the user asks about Jira CLI syntax.
Original author description
Reference guide for Atlassian CLI (acli) commands. Use when running acli commands for JQL queries, ticket transitions, comments, or workflow operations, or when the user asks about Jira CLI syntax.
How it works
- Search Commands
- JQL Syntax
- View Commands
- Comment Commands
- Transition Commands
- Edit Commands
- Other Commands
- Project Commands
- Common Flags
- Workflow Patterns
SKILL.md preview
---
name: jira-cli
description: Reference guide for Atlassian CLI (acli) commands. Use when running acli commands for JQL queries, ticket transitions, comments, or workflow operations, or when the user asks about Jira CLI syntax.
---
# Atlassian CLI (acli) - Jira Command Reference
## Search Commands
```bash
acli jira workitem search --jql "project = <PROJECT> AND assignee = currentUser() AND resolution = Unresolved"
acli jira workitem search --jql "project = <PROJECT>" --fields "key,status,summary"
acli jira workitem search --jql "project = <PROJECT>" --limit 50 --paginate
acli jira workitem search --jql "project = <PROJECT>" --count
```
Output flags: `--json`, `--csv`, `--web`
## JQL Syntax
- Single quotes for values with spaces: `status = 'Some Status'`
- Avoid `!=` with backslash - use `NOT status = 'Done'` instead
- Functions: `currentUser()`, `now()`, `startOfDay()`, `endOfWeek()`
- Status categories: `statusCategory = Done`, `statusCategory = 'In Progress'`
- Operators: `AND`, `OR`, `NOT`, `IN`, `IS`, `IS NOT`, `~` (contains), `ORDER BY`
### Common JQL Patterns
```sql
project = <PROJECT> AND assignee = currentUser() AND resolution = Unresolved
project = <PROJECT> AND status = '<status-name>'
project = <PROJECT> AND statusCategory = 'In Progress'
project = <PROJECT> AND updated >= -7d ORDER BY updated DESC
project = <PROJECT> AND Sprint = '<sprint-name>'
project = <PROJECT> AND component = <component>
```
## View Commands
```bash
acli jira workitem view <KEY>
acli jira workitem view <KEY> --fields "summary,description,status,comment"
acli jira workitem view <KEY> --fields "*all" --json
```
Field values: `*all` (all fields), `*navigable` (navigable fields), `-fieldname` (exclude field)
## Comment Commands
```bash
acli jira workitem comment create --key <KEY> --body "Comment text"
acli jira workitem comment create --key <KEY> --body-file comment.txt
acli jira workitem comment create --jql "project = <PROJECT> AND labels = needs-review" --body "Reviewed"
acli jira workitem comment list --key <KEY>
acli jira workitem comment create --key <KEY> --edit-last --body "Updated comment"
acli jira workitem comment create --key <KEY> --editor
```
### ADF (Atlassian Document Format)
Jira Cloud uses ADF (JSON-based). Plain `\n` newlines don't create paragraph breaks.
**acli limitations:** Headings, text marks (bold/italic/code), and code block syntax highlighting are rejected or stripped.
**Supported:** Paragraphs, bullet/ordered lists, code blocks (no highlighting).
```json
{"version":1,"type":"doc","content":[{"type":"paragraph","content":[{"type":"text","text":"Your text"}]}]}
```
```json
{"version":1,"type":"doc","content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"text","text":"Item one"}]}]}]}]}
```
```json
{"version":1,"type":"doc","content":[{"type":"codeBlock","attrs":{"language":"python"},"content":[{"type":"text","text":"def hello():\n print('Hello')"}]}]}
```
```bash
acli jira workitem comment create --key <KEY> --body '{"version":1,"type":"doc","content":[...]}'
acli jira workitem comment create --key <KEY> --body-file comment.json
```
## Transition Commands
```bash
acli jira workitem transition --key <KEY> --status "Done"
acli jira workitem transition --key "<KEY1>,<KEY2>" --status "<status>"
acli jira workitem transition --jql "project = <PROJECT> AND labels = ready" --status "Done" --yes
acli jira workitem transition --filter 10001 --status "Done"
```
## Edit Commands
```bash
acli jira workitem edit --key <KEY> --summary "New title"
acli jira workitem edit --key <KEY> --description "New description"
acli jira workitem edit --key <KEY> --description-file desc.txt
acli jira workitem edit --key <KEY> --assignee "user@example.com" # or "@me" or "default"
acli jira workitem edit --key <KEY> --remove-assignee
acli jira workitem edit --key <KEY> --labels "bug,urgent"
acli jira workitem edit --key <KEY> --remove-labels "wontfix"
acli jira workitem edit --key <KEY> --type "Bug"
acli jira workitem edit --jql "project = <PROJECT> AND labels = old" --labels "new" --yes
acli jira workitem edit --from-json workitem.json
acli jira workitem edit --generate-json
```
## Other Commands
```bash
# Attachments
acli jira workitem attachment list --key <KEY>
acli jira workitem attachment delete --key <KEY> --attachment-id 12345
# Links
acli jira workitem link create --key <KEY> --link-type "blocks" --outward-key <OTHER-KEY>
acli jira workitem link list-types
# Watchers
acli jira workitem watcher add --key <KEY> --user "user@example.com"
acli jira workitem watcher remove --key <KEY> --user "user@example.com"
# Misc
acli jira workitem clone --key <KEY>
acli jira workitem archive --key <KEY>
acli jira workitem unarchive --key <KEY>
acli jira workitem delete --key <KEY>
```
## Project Commands
```bash
acli jira project list --recent
acli jira project view --key <PROJECT>
acli jira project view --key <PROJECT> --json
```
## Common Flags
| Flag | Short | Description |
|------|-------|-------------|
| `--key` | `-k` | Ticket key(s), comma-separated |
| `--jql` | `-j` | JQL query string |
| `--filter` | | Saved filter ID |
| `--json` | | Output as JSON |
| `--csv` | | Output as CSV |
| `--web` | `-w` | Open in browser |
| `--yes` | `-y` | Skip confirmation prompts |
| `--limit` | `-l` | Maximum results |
| `--paginate` | | Fetch all results |
| `--fields` | `-f` | Fields to include |
| `--ignore-errors` | | Continue on errors |
## Workflow Patterns
### Review Tickets Workflow
When reviewing ticket status against codebase:
1. List open tickets: `acli jira workitem search --jql "assignee = currentUser() AND resolution = Unresolved" --fields "key,status,summary"`
2. For each ticket, search git history: `git log --oneline --grep="<KEY>"`
3. Check if work is deployed: compare commits against release tags
4. Transition or comment as needed
### Transitions
Transition syntax: `acli jira workitem transition --key <KEY> --status "<target-status>"`
Common workflow patterns vary by organization. Consult your team's workflow documentation for valid status transitions.
### Batch Operations
```bash
# Add same comment to multiple tickets
acli jira workitem comment create --key "<KEY1>,<KEY2>,<KEY3>" --body "Batch update: <message>"
# Transition multiple tickets
acli jira workitem transition --key "<KEY1>,<KEY2>" --status "Done" --yes
```
## Error Handling
- Use `--ignore-errors` to continue when some operations fail
- JQL errors often indicate syntax issues - check quotes and escapes
- Transition errors may indicate invalid target status for current state
- Use `--web` to debug by viewing in Jira UI
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · znorris/claude-marketplace | 100 | MIT |
| mgiovani/cc-arsenal | 100 | MIT |
| gchiam/claude-code-plugins | 95 | MIT |
Database snapshot: 13.11.2026 · package version 62cee9c9b350 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 92jira
Jira issue management using jira-cli. Search, create, view, comment, and transition issues with JQL queries. Use when working with Jira tickets, Atlassian issues, sprint planning, or issue workflows. - 82acli
Atlassian CLI (official `acli` binary) for Jira Cloud, Confluence Cloud, and org admin tasks from the terminal. Use whenever the user wants to create, view, edit, transition, assign, clone, archive, comment on, link, or bulk-operate on Jira work items; list or manage projects,… - 100jira-expert
Atlassian Jira expert for creating and managing projects, planning, product discovery, JQL queries, workflows, custom fields, automation, reporting, and all Jira features. Use for Jira project setup, configuration, advanced search, dashboard creation, workflow design, and technical Jira operations. - 100jira-expert
Atlassian Jira expert for creating and managing projects, planning, product discovery, JQL queries, workflows, custom fields, automation, reporting, and all Jira features. Use when setting up or configuring Jira projects, writing JQL and advanced searches, creating dashboards,… - 100jira-integration
Use when the user says \"check Jira\", \"create ticket\", \"update issue\", or needs JQL queries, ticket transitions, or branch-to-ticket linking. - 90jira
Search, read, draft, create, update, or transition Jira Cloud issues; use for comments, labels, acceptance criteria, and JQL.