atlassian-cli

Atlassian CLI（acli）

acli は、Atlassian Cloud 製品のタスクを自動化し、連携するための Atlassian 公式コマンドラインインターフェースです。バイナリ名は acli です。公式リファレンス：https://developer.atlassian.com/cloud/acli/reference/commands/

トップレベルのコマンドツリー

acli
├── admin              # Organization-admin operations
│   ├── auth           # login | logout | status | switch
│   └── user           # activate | cancel-delete | deactivate | delete
├── feedback           # Submit requests or report issues to Atlassian
├── jira               # Jira Cloud operations
│   ├── auth           # login | logout | status | switch
│   ├── board          # list-sprints | search
│   ├── dashboard      # search
│   ├── field          # cancel-delete | create | delete
│   ├── filter         # add-favourite | change-owner | list | search
│   ├── project        # archive | create | delete | list | restore | update | view
│   ├── sprint         # list-workitems
│   └── workitem       # archive | assign | attachment-delete | attachment-list |
│                      # clone | comment-create | comment-delete | comment-list |
│                      # comment-update | comment-visibility | create | create-bulk |
│                      # delete | edit | link | search | transition | unarchive |
│                      # view | watcher-remove
└── rovodev            # Atlassian's AI coding agent (Beta)
    └── auth           # Authenticate Rovo Dev CLI

-h / --help フラグはすべてのコマンドとサブコマンドで利用でき、その最下位コマンドで使用できる正確なフラグ一覧を確認できます。フラグの形式が不明な場合は、acli <command> --help が信頼できる情報源です。

認証モデル

独立した認証コンテキストが並行して 2 つ存在します。

• acli jira auth — Jira Cloud サイトを対象とします（ユーザートークンまたは OAuth）。
• acli admin auth — Atlassian 組織の管理者アカウントを対象とします。

acli jira auth login では、次のフラグを指定できます。

フラグ	用途
--web、-w	ブラウザーを使った OAuth フロー
--site、-s	Atlassian サイト（例：mysite.atlassian.net）
--email、-e	ユーザーのメールアドレス（トークン認証で必須）
--token	標準入力から API トークンを読み込みます（シェル履歴にトークンが残りません）

標準入力からトークンを渡す例：echo "$API_TOKEN" | acli jira auth login --site mysite.atlassian.net --email [email protected] --token。Windows では Get-Content を使用します。

acli jira auth status では現在認証されているアカウントを確認できます。複数のアカウントにログインしている場合は、switch でアクティブなアカウントを切り替えられます。logout は認証情報を削除します。

Jira 作業項目のコマンド — 主な機能

jira workitem は、最も多機能なコマンドグループです。詳細はリファレンスを参照してください。

選択方法の基本

変更を伴うほとんどのサブコマンド（edit、assign、transition、delete、archive、unarchive、clone）では、次の選択方法を使用できます。

• --key "KEY-1,KEY-2" — カンマ区切りの作業項目キー
• --jql "project = TEAM AND status = 'In Progress'" — JQL クエリ
• --filter 10001 — 数値の保存済みフィルター ID
• --from-json path.json — 構造化された定義ファイル
• --from-file path.txt — プレーンテキストのリスト（assign 用）

この統一された選択方法により、同じコマンド体系で一括操作を実行できます。

一括操作でよく使うフラグ

フラグ	動作
--yes	対話形式の確認を省略します
--ignore-errors	エラーが発生しても、残りの項目の処理を続行します
--json	機械可読な形式で出力します
--generate-json	--from-json で使用するテンプレート JSON を出力します

作成（acli jira workitem create）

必須項目：--project、--type、--summary。任意項目：--assignee（自分を指定する場合は @me）、--description、--description-file、--label（カンマ区切り）、親項目との関連付けに使うフラグ、--from-file、--from-json、--editor、--generate-json、--json。

検索（acli jira workitem search）

--jql または --filter を指定します。出力を制御するフラグ：--fields（デフォルトは issue type, key, assignee, priority, status, summary）、--csv、--json、--limit、--paginate（すべてのページを取得）、--count（合計のみ）、--web（ブラウザーで開く）。

表示（acli jira workitem view KEY-123）

位置引数には作業項目キーを指定します。--fields には次の値を指定できます。

• *all — すべてのフィールド
• *navigable — ナビゲーション可能なフィールド
• カンマ区切りのリスト：summary,comment
• 除外：-description

デフォルトのフィールドセット：key,issuetype,summary,status,assignee,description。

ステータス変更（acli jira workitem transition）

選択方法と --status "Done"（移行先のステータス名）が必要です。一括処理では --key、--jql、--filter を使用できます。

担当者の割り当て（acli jira workitem assign）

--assignee にはメールアドレス、アカウント ID、@me、または default（プロジェクトのデフォルト）を指定できます。--remove-assignee を指定すると、担当者を解除します。

編集（acli jira workitem edit）

要約、説明、担当者、タイプ、ラベルを更新します（追加・削除）。すべての選択方法に対応し、一括更新のテンプレート生成には --generate-json を使用できます。

Jira プロジェクト、ボード、スプリント、フィルター、フィールド、ダッシュボード

簡潔なコマンドリファレンスはreferences/jira-other.mdにあります。主な内容：

• jira project create — 3つの入力モード：--from-project（複製）、--from-json（テンプレートベース）、または直接フラグ（--key、--name、--description、--url、--lead-email）。
• jira project list | view | update | archive | restore | delete — ライフサイクル全体を管理します。
• jira board search および jira board list-sprints — ボードの検索とスプリントの一覧表示。
• jira sprint list-workitems — 指定したスプリントのワークアイテム。
• jira filter list | search | add-favourite | change-owner — 保存済みフィルターの管理。
• jira field create | delete | cancel-delete — カスタムフィールドのライフサイクル（復元可能なソフト削除）。
• jira dashboard search — ダッシュボードの検索。

管理者機能と Rovo Dev

references/admin-rovodev.mdを参照してください。

• admin user activate | deactivate | delete | cancel-delete — 管理対象アカウントのライフサイクル。ソフト削除はcancel-deleteで取り消せます。
• admin auth login | logout | status | switch — Jira 認証とは別の、組織管理者向け認証。
• rovodev auth — Rovo Dev CLI（Atlassian の AI コーディングエージェント、ベータ版）の認証。

よくあるワークフローのレシピ

一般的な自動化タスク（デイリースタンドアップレポート、スプリントの切り替え、一括再割り当て、JQL によるエクスポート）のレシピスニペットはreferences/recipes.mdにあります。

プラットフォームと制限事項

• macOS、Linux、Windows でサポートされています。各プラットフォームのパッケージマネージャーからインストールできます（Atlassian のインストールガイドを参照）。
• Atlassian Government Cloud はサポートされていません。
• シェルの自動補完はacliの補完設定から利用できます。