4 + Atlassian CLI (acli) for Jira, Confluence, Rovo Dev, and org admin.
5 + Use when: working with Jira issues/projects/boards/sprints, Confluence
6 + pages/spaces/blogs, Atlassian org users, or Rovo Dev. Triggers on:
7 + jira, confluence, rovo, atlassian, work item, sprint, JQL, confluence page/space/blog.
10 +#
Atlassian CLI (`acli`) 12 +CLI for Atlassian Cloud. Docs: <https://developer.atlassian.com/cloud/acli/>
16 +- `acli` installed (`brew install acli`, `apt`, or from <https://developer.atlassian.com/cloud/acli/guides/install-acli/>)
17 +- Authenticated per product:
21 +acli confluence auth login
22 +acli rovodev auth login
23 +acli admin auth login
29 +acli jira auth status
30 +acli confluence auth status
36 +acli <product> <resource> <action> [flags]
39 +Products: `jira`, `confluence`, `rovodev`, `admin`
43 +###
Work Items (issues) 47 +acli jira workitem create --summary
"Title" --project PROJ --type Task
48 +acli jira workitem create --summary
"Bug" --project PROJ --type Bug --assignee @me --label
"backend,urgent" 49 +acli jira workitem create --description
"plain text or ADF JSON" --description-file desc.txt -p PROJ -t Story -s
"Title" 52 +acli jira workitem create --generate-json
> workitem.json
54 +acli jira workitem create --from-json workitem.json
57 +acli jira workitem create-bulk --from-csv issues.csv
58 +acli jira workitem create-bulk --from-json issues.json
61 +acli jira workitem view KEY-123
62 +acli jira workitem view KEY-123 --fields summary,status,assignee,description --json
63 +acli jira workitem view KEY-123 --web
66 +acli jira workitem search --jql
"project = PROJ AND status = Open" --paginate
67 +acli jira workitem search --jql
"assignee = currentUser() AND sprint in openSprints()" --fields
"key,summary,priority" --json
68 +acli jira workitem search --jql
"project = PROJ" --csv --limit 50
69 +acli jira workitem search --filter 10001
72 +acli jira workitem edit --key KEY-123 --summary
"Updated title" 73 +acli jira workitem edit --key KEY-1,KEY-2 --assignee user@example.com
74 +acli jira workitem edit --jql
"project = PROJ AND status = 'To Do'" --assignee @me
77 +acli jira workitem transition --key KEY-123 --status
"In Progress" 78 +acli jira workitem transition --jql
"project = PROJ" --status Done --yes
81 +acli jira workitem clone --key KEY-123 --to-project OTHER
84 +acli jira workitem comment create --key KEY-123 --body
"comment text" 85 +acli jira workitem comment create --key KEY-123 --body-file comment.txt
86 +acli jira workitem comment list --key KEY-123
87 +acli jira workitem comment update --key KEY-123 --id COMMENT_ID --body
"updated" 88 +acli jira workitem comment delete --key KEY-123 --id COMMENT_ID
91 +acli jira workitem link create --key KEY-1 --target KEY-2 --type
"Blocks" 92 +acli jira workitem link list --key KEY-1
93 +acli jira workitem link type
96 +acli jira workitem attachment list --key KEY-123
97 +acli jira workitem attachment delete --key KEY-123 --id ATTACHMENT_ID
100 +acli jira workitem assign --key KEY-123 --assignee user@example.com
101 +acli jira workitem archive --key KEY-123
102 +acli jira workitem delete --key KEY-123 --yes
103 +acli jira workitem watcher list --key KEY-123
104 +acli jira workitem watcher remove --key KEY-123 --user user@example.com
110 +acli jira project list
111 +acli jira project view PROJ
112 +acli jira project create --key PROJ --name
"Project Name" 113 +acli jira project update PROJ --name
"New Name" 114 +acli jira project archive PROJ
115 +acli jira project delete PROJ
118 +###
Boards & Sprints 121 +acli jira board search --project PROJ
122 +acli jira board get BOARD_ID --json
123 +acli jira board list-sprints BOARD_ID
124 +acli jira sprint create --board BOARD_ID --name
"Sprint 1" 125 +acli jira sprint view SPRINT_ID
126 +acli jira sprint list-workitems SPRINT_ID
127 +acli jira sprint update SPRINT_ID --state closed
130 +###
Filters & Fields 133 +acli jira filter list
134 +acli jira filter search --jql
"project = PROJ" 135 +acli jira field create --name
"My Field" --type text
144 +acli confluence page view --id PAGE_ID
145 +acli confluence page view --id PAGE_ID --json
146 +acli confluence page view --id PAGE_ID --body-format storage
147 +acli confluence page view --id PAGE_ID --body-format atlas_doc_format
148 +acli confluence page view --id PAGE_ID --include-labels --include-version
154 +acli confluence space list
155 +acli confluence space view --key SPACEKEY
156 +acli confluence space create --key SPACEKEY --name
"Space Name" --description
"desc" 157 +acli confluence space update --key SPACEKEY --name
"New Name" 158 +acli confluence space archive --key SPACEKEY
159 +acli confluence space restore --key SPACEKEY
165 +acli confluence blog create --space-id 12345 --title
"Post" --body
"<p>Content</p>" 166 +acli confluence blog create --space-id 12345 --title
"Draft" --status draft --body
"text" 167 +acli confluence blog create --space-id 12345 --title
"Post" --from-file content.html
168 +acli confluence blog create --from-json payload.json
169 +acli confluence blog list --space-id 12345
170 +acli confluence blog view --id BLOG_ID
175 +AI coding agent (beta). Requires separate API token.
178 +acli rovodev auth login
185 +acli admin user activate --account-id USER_ID
186 +acli admin user deactivate --account-id USER_ID
187 +acli admin user delete --account-id USER_ID
188 +acli admin user cancel-delete --account-id USER_ID
194 +| ----------- | --------------------------- |
195 +| `--json` | JSON output |
196 +| `--csv` | CSV output (search only) |
197 +| `--web` | Open in browser |
198 +| `--paginate`| Fetch all pages of results |
199 +| `--limit N` | Cap results |
204 +--yes / -y Skip confirmation prompts
205 +--json Machine-readable output
208 +##
JQL Quick Reference 211 +project = PROJ Filter by project
212 +status = Open By status
213 +assignee = currentUser() My issues
214 +assignee = @me (alias in some commands)
215 +sprint in openSprints() Current sprint
216 +type = Bug By issue type
217 +priority = High By priority
218 +text ~ "search term" Full-text search
219 +created >= "2025-01-01" Date range
220 +updated <= -1d Relative date
221 +ORDER BY priority DESC Sorting
224 +Combine with `AND` / `OR` / `NOT`. Group with `()`.
225 +Use `--paginate` for large result sets.
227 +##
Description & Comment Format 229 +acli accepts plain text for descriptions/comments. For rich formatting, use
230 +Atlassian Document Format (ADF) JSON:
233 +acli jira workitem create --generate-json
236 +ADF is verbose. For simpler markup conversion, use pandoc:
240 +echo '# Title\n\n**bold** _italic_' | pandoc -f markdown -t jira
244 +echo 'h1. Title' | pandoc -f jira -t markdown
248 +Note: acli's `--description` accepts plain text or ADF JSON, not Jira wiki
249 +markup. Use pandoc's `jira` format for converting existing wiki markup to
250 +readable text. For Confluence, `--body` accepts Confluence storage format (XHTML).
254 +###
Find my open bugs this sprint 257 +acli jira workitem search --jql
"assignee = currentUser() AND type = Bug AND sprint in openSprints()" --paginate --json
260 +###
Bulk transition to Done 263 +acli jira workitem transition --jql
"project = PROJ AND status = 'In Review'" --status Done --yes
266 +###
Create sub-task under epic 269 +acli jira workitem create --summary
"Sub-task" --project PROJ --type
"Sub-task" --parent EPIC-1 --assignee @me
272 +###
Export issues as CSV 275 +acli jira workitem search --jql
"project = PROJ" --fields
"key,summary,status,assignee" --csv
> issues.csv
280 +###
"failed to parse JQL query" 282 +JQL field values are case-sensitive. Quote strings with spaces.
283 +Use `=` (exact), `~` (fuzzy/contains), `!=`, `!~` (not contains).
288 +acli jira auth status
289 +acli jira auth login
294 +Use `--limit` to cap results. Avoid `--paginate` in tight loops.