| name | atl-cli |
| description | Atlassian Server CLI (Jira/Confluence/Bitbucket). This skill should be used when working with Jira issues, Confluence page operations, Bitbucket pull requests, or any Atlassian Server tasks. Triggers on: issue tracking, wiki pages, PR management, CQL queries. |
ATL CLI
atl
├── init # Setup config
├── issue (jira)
│ ├── list (ls, search) [text] # -t -s[] -y -a -r -e -C -l[] -p -q --order-by --reverse --limit
│ ├── view [key]
│ ├── comment [key] [text]
│ ├── comments [key]
│ ├── transition [key] [name?] # Omit name to list available
│ └── prs [key] # Linked pull requests
├── page (confluence)
│ ├── list [space] # --type --limit
│ ├── search (find, query) [text] # -s -t --title --creator --contributor --created --modified -q --order-by --reverse --limit
│ ├── view [id] # --format --info -o --with-images --with-toc
│ ├── create # -s -t -c -f -p
│ ├── edit [id] # -t -c -f
│ ├── delete (rm, del) [id|title|url] # -s --cascade -y
│ ├── children [id] # --limit
│ └── spaces # --limit
└── pr
├── list [proj/repo] # --state --author --base --head --limit
├── view [proj/repo] [id]
├── diff [proj/repo] [id]
├── comment [proj/repo] [id] [text]
├── merge [proj/repo] [id] # --force --delete-branch
└── status # Your PRs & reviews
Global: --config, --username
Jira Issue List
atl issue list -a me -t Bug -s Open # My open bugs
atl issue list -s '~Done' -e 123 # Not Done, epic auto-prefixed
atl issue list -q "created >= -7d" # Raw JQL
| Flag | Values |
|---|---|
-t |
Bug, Story, Task, Epic |
-s |
Status (multi, ~ negates) |
-y |
Blocker, Critical, Major, Minor, Trivial |
-a |
me, none, x, username |
-e |
Epic key (auto-prefixes project) |
--order-by |
created, updated, priority, status, key, assignee, reporter, summary |
Confluence Page Search
atl page search "notes" -s '~john.doe'
atl page search --title "CLI" --creator john.doe --modified month
atl page search -q 'type=page AND title~"API"'
| Flag | Values |
|---|---|
-t |
page, blogpost, comment, attachment |
--modified |
today, yesterday, week, month, year |
--order-by |
created, lastmodified, title |
Confluence Page View/Create/Edit
atl page view 12345 --format storage -o page.html # Fetch before edit
atl page create -s SPACE -t "Title" -f content.html -p "Parent"
atl page edit 12345 -f updated.html
atl page delete 12345 --cascade -y
-p/--parent: ID, title (needs space), or URL
Bitbucket PR
atl pr list PROJ/repo --state ALL --author @me
atl pr merge PROJ/repo 140 --force --delete-branch
atl pr status
| --state | OPEN, MERGED, DECLINED, ALL |
Pitfalls
# Quote tilde - shell expansion
atl page list '~john.doe' # RIGHT
atl page list ~john.doe # WRONG
# Positional arg, not --space
atl page list '~john.doe' # RIGHT
atl page list --space SPACE # WRONG
# No CDATA in Confluence storage
<pre>code</pre> # RIGHT
<![CDATA[code]]> # WRONG
Read references/confluence-guidelines.md before editing pages.