コマンドリファレンス

atlassian-cli の全コマンドを製品ごとにまとめています。実行例はデフォルトのプロファイルを使用します。別のプロファイルを対象にする場合は --profile <name> を追加してください。プロファイルの設定方法は認証を参照してください。

グローバルフラグ

次のフラグはすべてのコマンドで使用できます。

--profile <name>: 指定した認証プロファイルを使用します（デフォルトは auth list で default と表示されるプロファイル）
--format <table|json|csv|yaml|quiet|markdown> または -f: 出力形式（デフォルトは table）
--envelope: JSON/YAML のリスト出力を {"data": [...], "count": N} で包み、後続処理での解析を容易にします
--config <path>: デフォルト以外の設定ファイルを使用します（既定値は ~/.atlassian-cli/config.yaml）
--debug: 調査用に HTTP リクエストとレスポンスの詳細をログ出力します
--help: コマンドのヘルプを表示します

bulk サブコマンドでは、さらに --dry-run、--concurrency <n>、--limit <n> を指定できます。

出力形式

# Human-readable table (default)
atlassian-cli jira issue search --jql "project = DEV"

# Machine-readable JSON: pipe to jq, feed other tools
atlassian-cli jira issue search --jql "project = DEV" --format json | jq '.[].key'

# CSV: open in a spreadsheet
atlassian-cli jira issue search --jql "project = DEV" --format csv --output issues.csv

# YAML: good for configuration diffs
atlassian-cli jira workflows export "Software Simplified Workflow" --format yaml

# Quiet: exit code only; useful in CI gating
atlassian-cli auth test --profile prod --format quiet && echo OK

auth

詳しくは認証とプロファイルのガイドを参照してください。利用できるサブコマンドは login、logout、list、status、whoami、test です。

atlassian-cli auth login --profile work --base-url https://x.atlassian.net --email you@x.com --token $TOKEN --default
atlassian-cli auth list
atlassian-cli auth status
atlassian-cli auth whoami --profile work
atlassian-cli auth test --profile work
atlassian-cli auth logout --profile old                    # remove credentials, keep profile
atlassian-cli auth logout --profile old --remove-profile   # remove profile entirely
atlassian-cli auth logout --profile old --bitbucket        # only remove Bitbucket token

デフォルトのプロファイルを変更するには、デフォルトにしたいプロファイルで auth login --default を再実行してください。または default_profile: の値を ~/.atlassian-cli/config.yaml で直接編集します。

Jira: 課題

atlassian-cli jira issue search --jql "project = DEV order by created desc" --limit 5
atlassian-cli jira issue get DEV-123
atlassian-cli jira issue create --project DEV --issue-type Task --summary "Test task"

# Custom fields: discover IDs via `jira fields list`
atlassian-cli jira issue create --project DEV --issue-type Task --summary "cf test" \
  --field 'customfield_10010={"value":"Internal"}' \
  --field 'customfield_10020={"formula":"a=b"}'

atlassian-cli jira issue update DEV-123 --summary "Updated summary"
atlassian-cli jira issue transition DEV-123 --transition "In Progress"
atlassian-cli jira issue assign DEV-123 --assignee user@example.com
atlassian-cli jira issue delete DEV-123

# Assign to a sprint by numeric sprint id (Agile API; no customfield id needed)
atlassian-cli jira issue update DEV-123 --sprint 25446
atlassian-cli jira issue create --project DEV --issue-type Task --summary "In sprint" --sprint 25446

Jira: プロジェクト

atlassian-cli jira project list
atlassian-cli jira project get DEV
atlassian-cli jira components list DEV
atlassian-cli jira versions list DEV

Jira: ロール

atlassian-cli jira roles list DEV
atlassian-cli jira roles get DEV 10002
atlassian-cli jira roles actors DEV 10002
atlassian-cli jira roles add-actor DEV 10002 --user user@example.com
atlassian-cli jira roles remove-actor DEV 10002 --user user@example.com

Jira: フィールドとワークフロー

atlassian-cli jira fields list
atlassian-cli jira workflows list
atlassian-cli jira workflows export "Software Simplified Workflow"

Jira: 一括操作

# Dry-run first, always
atlassian-cli jira bulk transition \
  --jql "project = DEV AND status = Open" \
  --transition "In Progress" \
  --dry-run

atlassian-cli jira bulk assign \
  --jql "project = DEV AND assignee is EMPTY" \
  --assignee admin@example.com

atlassian-cli jira bulk export \
  --jql "project = DEV" \
  --output issues.json --format json

すべての bulk コマンドは --concurrency（デフォルトは 4）に従います。--format quiet を指定しない限り、進捗バーをリアルタイムで表示します。

Jira: 自動化と Webhook

atlassian-cli jira automation list
atlassian-cli jira webhooks list
atlassian-cli jira audit list --from 2025-01-01 --limit 100

Confluence: 検索

atlassian-cli confluence search cql "space = DEV and type = page" --limit 5
atlassian-cli confluence search text "meeting notes" --limit 10
atlassian-cli confluence search in-space DEV "api docs"

Confluence: スペース

atlassian-cli confluence space list --limit 10
atlassian-cli confluence space get DEV
atlassian-cli confluence space create --key DOCS --name "Documentation" --description "Team docs"
atlassian-cli confluence space update DEV --name "Development Space"
atlassian-cli confluence space delete OLD --force
atlassian-cli confluence space permissions DEV
atlassian-cli confluence space add-permission --permission read --subject-type user --subject-id user@example.com DEV

Confluence: ページ

atlassian-cli confluence page list --space DEV --limit 25
atlassian-cli confluence page get 12345
atlassian-cli confluence page create --space DEV --title "New Page" --body "<p>Content</p>"
atlassian-cli confluence page update 12345 --title "Updated Title"
atlassian-cli confluence page delete 12345
atlassian-cli confluence page versions 12345
atlassian-cli confluence page add-label 12345 documentation
atlassian-cli confluence page remove-label 12345 outdated
atlassian-cli confluence page comments 12345
atlassian-cli confluence page add-comment 12345 "Great work!"
atlassian-cli confluence page get-restrictions 12345
atlassian-cli confluence page add-restriction --operation update --subject-type user --subject-id user@example.com 12345
atlassian-cli confluence page remove-restriction --operation update --subject-type user --subject-id user@example.com 12345

Confluence: ブログ記事

atlassian-cli confluence blog list --space DEV --limit 10
atlassian-cli confluence blog get 67890
atlassian-cli confluence blog create --space DEV --title "Sprint Recap" --body "<p>Summary</p>"
atlassian-cli confluence blog update 67890 --title "Updated Recap"
atlassian-cli confluence blog delete 67890

Confluence: フォルダー 0.4 で追加

atlassian-cli confluence folder get 3309240341
atlassian-cli confluence folder create --space DOCS --title "Architecture" --parent 3302031761
atlassian-cli confluence folder delete 3309240341 --force

Confluence: 添付ファイル

atlassian-cli confluence attachment list 12345
atlassian-cli confluence attachment get 11111
atlassian-cli confluence attachment upload --file ./diagram.png 12345
atlassian-cli confluence attachment download --output ./download.png 11111
atlassian-cli confluence attachment delete 11111

Confluence: 一括操作

atlassian-cli confluence bulk delete --cql "space = OLD" --dry-run
atlassian-cli confluence bulk add-labels --cql "space = DEV" --labels docs,reviewed --dry-run
atlassian-cli confluence bulk export --cql "space = DEV" --output backup.json --format json

Markdown から Confluence への一連のパイプラインについては、Markdown 同期ランブックを参照してください。

Confluence: 分析

atlassian-cli confluence analytics page-views 12345 --from 2025-01-01
atlassian-cli confluence analytics space-stats DEV

Bitbucket: ユーザー情報

bb は bitbucket のエイリアスです。以下のすべてのコマンドで、どちらの表記も使用できます。

atlassian-cli bitbucket whoami
atlassian-cli bb whoami

Bitbucket: リポジトリ

atlassian-cli bitbucket --workspace myteam repo list --limit 10
atlassian-cli bitbucket --workspace myteam repo get api-service
atlassian-cli bitbucket --workspace myteam repo create newrepo --name "New Repo" --private
atlassian-cli bitbucket --workspace myteam repo update api-service --description "Updated description"
atlassian-cli bitbucket --workspace myteam repo delete oldrepo --force

Bitbucket: ブランチ

atlassian-cli bitbucket --workspace myteam branch list api-service
atlassian-cli bitbucket --workspace myteam branch create api-service feature/new --from main
atlassian-cli bitbucket --workspace myteam branch delete api-service feature/old --force
atlassian-cli bitbucket --workspace myteam branch protect api-service --pattern "main" --kind restrict_merges --approvals 2
atlassian-cli bitbucket --workspace myteam branch restrictions api-service

Bitbucket: プルリクエスト

atlassian-cli bitbucket --workspace myteam pr list api-service --state OPEN --limit 5
atlassian-cli bitbucket --workspace myteam pr get api-service 123
atlassian-cli bitbucket --workspace myteam pr create api-service --title "Add feature" --source feature/new --destination main
atlassian-cli bitbucket --workspace myteam pr update api-service 123 --title "Updated title"
atlassian-cli bitbucket --workspace myteam pr approve api-service 123
atlassian-cli bitbucket --workspace myteam pr merge api-service 123 --strategy merge_commit
atlassian-cli bitbucket --workspace myteam pr comments api-service 123
atlassian-cli bitbucket --workspace myteam pr comment api-service 123 --text "Looks good!"

Bitbucket: ワークスペースとプロジェクト

atlassian-cli bitbucket workspace list --limit 10
atlassian-cli bitbucket workspace get myteam
atlassian-cli bitbucket --workspace myteam project list
atlassian-cli bitbucket --workspace myteam project create PROJ --name "My Project" --private
atlassian-cli bitbucket --workspace myteam project delete PROJ --force

Bitbucket: パイプライン

atlassian-cli bitbucket --workspace myteam pipeline list api-service
atlassian-cli bitbucket --workspace myteam pipeline trigger api-service --ref-name main

# Trigger a named custom pipeline from bitbucket-pipelines.yml (new in 0.4)
atlassian-cli bitbucket --workspace myteam pipeline trigger api-service --ref-name main --custom-pipeline s3-access-test

atlassian-cli bitbucket --workspace myteam pipeline stop api-service {uuid}

Bitbucket: Webhook と SSH キー

atlassian-cli bitbucket --workspace myteam webhook list api-service
atlassian-cli bitbucket --workspace myteam webhook create api-service --url https://example.com/hook --events repo:push
atlassian-cli bitbucket --workspace myteam ssh-key list api-service
atlassian-cli bitbucket --workspace myteam ssh-key add api-service --label deploy --key "ssh-rsa ..."

Bitbucket: 権限とコミット

atlassian-cli bitbucket --workspace myteam permission list api-service
atlassian-cli bitbucket --workspace myteam permission grant api-service --user-uuid {uuid} --permission write
atlassian-cli bitbucket --workspace myteam commit list api-service --branch main
atlassian-cli bitbucket --workspace myteam commit diff api-service abc123
atlassian-cli bitbucket --workspace myteam commit browse api-service --commit main --path src/

Bitbucket: 一括操作

atlassian-cli bitbucket --workspace myteam bulk archive-repos --days 180 --dry-run
atlassian-cli bitbucket --workspace myteam bulk delete-branches api-service --exclude feature/keep --dry-run

JSM: サービスデスク

atlassian-cli jsm service-desk list --limit 25
atlassian-cli jsm service-desk get 10
atlassian-cli jsm service-desk customers 10 --limit 25
atlassian-cli jsm service-desk add-customer 10 --account-id 5f...1a --account-id 6a...2b
atlassian-cli jsm service-desk remove-customer 10 --account-id 5f...1a
atlassian-cli jsm service-desk organizations 10
atlassian-cli jsm service-desk add-organization 10 --org-id 42
atlassian-cli jsm service-desk remove-organization 10 --org-id 42

JSM: リクエストタイプ

atlassian-cli jsm request-type list --servicedesk-id 10 --limit 25
atlassian-cli jsm request-type get 10 7
atlassian-cli jsm request-type fields 10 7
atlassian-cli jsm request-type groups 10

JSM: リクエスト

atlassian-cli jsm request list --servicedesk-id 10 --limit 25
atlassian-cli jsm request get SD-123
atlassian-cli jsm request create --servicedesk-id 10 --request-type-id 7 --summary "Access issue" --description "Can't log in"
atlassian-cli jsm request transitions SD-123
atlassian-cli jsm request transition SD-123 --transition "In Progress"
atlassian-cli jsm request status SD-123
atlassian-cli jsm request comments SD-123 --limit 25
atlassian-cli jsm request add-comment SD-123 --body "Investigating" --public
atlassian-cli jsm request participants SD-123
atlassian-cli jsm request add-participant SD-123 --account-id 5f...1a
atlassian-cli jsm request remove-participant SD-123 --account-id 5f...1a
atlassian-cli jsm request subscribe SD-123
atlassian-cli jsm request unsubscribe SD-123

JSM: キュー

atlassian-cli jsm queue list 10
atlassian-cli jsm queue get 10 5
atlassian-cli jsm queue issues 10 5 --limit 25

JSM: 承認

atlassian-cli jsm approval list SD-123
atlassian-cli jsm approval get SD-123 --approval-id 1
atlassian-cli jsm approval approve SD-123 --approval-id 1
atlassian-cli jsm approval decline SD-123 --approval-id 1

JSM: SLA

atlassian-cli jsm sla list SD-123
atlassian-cli jsm sla get SD-123 --sla-id time-to-resolution

JSM: 顧客

atlassian-cli jsm customer create --email new@customer.com --display-name "New Customer"
atlassian-cli jsm customer revoke-portal-access --account-id 5f...1a

JSM: 組織

atlassian-cli jsm organization list --limit 25
atlassian-cli jsm organization get 42
atlassian-cli jsm organization create --name "ACME Ops"
atlassian-cli jsm organization users 42 --limit 25
atlassian-cli jsm organization add-user 42 --account-id 5f...1a
atlassian-cli jsm organization remove-user 42 --account-id 5f...1a
atlassian-cli jsm organization delete 42

JSM: ナレッジベース

atlassian-cli jsm kb search --query "vpn" --servicedesk-id 10 --limit 25

JSM: フィードバック

atlassian-cli jsm feedback get SD-123
atlassian-cli jsm feedback submit SD-123 --rating 5 --comment "Great help"
atlassian-cli jsm feedback delete SD-123

次のステップ: 本番環境での実例はランブックを、より詳しい解説はブログをご覧ください。