acli-jiralisted

# Atlassian CLI (acli) for Jira Use `acli jira` for Jira Cloud operations via command line. ## Critical: Always Use --json Flag **The text/table output format has bugs.** Always add `--json` to commands for reliable output: ```bash # CORRECT - always use --json acli jira workitem view KEY-123 --json acli jira workitem search --jql "project = PROJ" --json # INCORRECT - will often fail with "unexpected error" acli jira workitem view KEY-123 acli jira workitem search --jql "project = PROJ" --csv ``` ## Intermittent API Errors `acli` may return intermittent `unexpected error` failures. For read-only commands, retry with a bounded attempt count: ```bash # If this fails with a transient error, retry it a few times. acli jira workitem view PROJ-123 --json ``` Do **not** blindly retry non-idempotent writes such as `workitem create`: the server may have completed the request even when the CLI lost the response. Query Jira for the expected result first, then retry only when it was not created. For transitions, assignments, and edits, inspect the current field value before retrying. For critical operations, consider using MCP tools when they are more reliable. ## Confirm Write-command Syntax The write subcommands use flag-based selectors, and their flags may differ between `acli` releases. Before an unfamiliar or bulk write, check the installed command: ```bash acli jira workitem transition --help acli jira workitem assign --help acli jira workitem edit --help ``` Current