Atlassian 公式 acli で Jira を操作する: オープンソースの代替も比較

atlassian-cli はコミュニティによる独立したオープンソースプロジェクトです。Atlassian と提携・関連しておらず、Atlassian による承認、推奨、後援のいずれも受けておらず、Atlassian が提供する公式 CLI（acli）でもありません。製品名は互換性を示す目的でのみ使用しています。

acli とは何か（そして何ではないか）

acli は Atlassian 自身が提供する公式のコマンドラインインターフェースです。Jira 関連の機能は acli jira コマンドグループにまとまっています。「acli jira」で検索しているなら、探しているのは Atlassian が提供するツールです。Web の UI をクリックする代わりに、ターミナルから Jira の work item を作成、検索、担当者設定、遷移させられます。Atlassian が開発とサポートを行い、macOS、Windows、Linux 向けに配布されています。一括操作時の影響通知やプレビューといった安全機能も備えています。

Atlassian の acli は、Jira 関連の機能を auth、workitem、board、dashboard、field、filter、project、sprint というサブコマンドグループに整理しています。Jira 以外にも、組織管理向けの acli admin と、Atlassian の AI コーディングエージェント Rovo Dev を扱う acli rovodev があります。一方で acli は、Atlassian のすべての製品を 1 つのバイナリで扱うことを目指してはいません。重点は Jira と組織管理であり、Jira と Confluence と Bitbucket と JSM をまとめたツールチェーンではありません。

実際に使う acli jira コマンド

用語について一点補足します。Atlassian の新しい Jira の用語では課題を「work item」と呼ぶため、acli もサブコマンド名を workitem としています。Jira の課題と work item は同じものです。以下は日常的に使う acli jira コマンドです。

work item を作成する

# Create a Task in project TEAM
acli jira workitem create \
  --summary "New Task" \
  --project "TEAM" \
  --type "Task"

# Create from a JSON payload for full control over fields
acli jira workitem create --from-json ./workitem.json

JQL で検索する

# Return every work item in a project
acli jira workitem search --jql "project = TEAM"

--jql フラグは有効な Jira Query Language の式をそのまま受け取ります。高度な検索と同じ感覚で、ステータス、担当者、スプリント、期間で絞り込めます。

表示、担当者設定、遷移

# View one work item and pick which fields to print
acli jira workitem view TEAM-123 --fields summary,comment

# Reassign and move it through the workflow
acli jira workitem assign TEAM-123
acli jira workitem transition TEAM-123

acli には、日々の作業に対応する動詞も揃っています。edit、clone、link、delete、コメント管理（comment-create、comment-list、comment-update）、ウォッチャー、添付ファイル、そして多数の work item をまとめて作成する create-bulk などです。フラグや挙動はリリースによって変わることがあるため、正確な構文は暗記せず、Atlassian の公式 acli リファレンスで確認してください。

acli でサインインする

Jira のコマンドを実行する前に、acli には認証情報が必要です。認証は専用のサブコマンドにまとまっています。

acli jira auth login

ログインすると、上記の acli jira workitem コマンドが認証済みのサイトに対して実行されます。acli は Atlassian 自身のツールなので、サインインとトークンの扱いは Atlassian が管理し、オンボーディングガイドに記載されています。これは公式 CLI の実務上の利点のひとつです。Atlassian が次に何を提供しても、サードパーティが追いつくのを待たずに認証フローが追従します。

オープンソースの代替が向いている場面

acli は Jira の操作に優れており、シェルから自動化する対象が Jira だけなら、公式ツールが自然な既定の選択肢になります。差が出るのは、作業が複数の製品にまたがるときです。リリース担当者は、Jira の課題をクローズし、リリースノートを Confluence に公開し、Bitbucket のプルリクエストをマージし、JSM のリクエストを更新する、という一連の作業を 1 つのスクリプトで行うことがあります。4 つのツールと 4 つの認証フローを個別に扱うのは面倒です。

そこを埋めるのが独立したプロジェクトです。atlassian-cli は、Jira、Confluence、Bitbucket、Jira Service Management を 1 つの認証モデルと 1 つの出力規約で扱う、MIT ライセンスの単一バイナリです。Atlassian のサポート契約を置き換えるものではありません。Atlassian と提携・関連しておらず、Atlassian による承認、推奨、後援、保守のいずれも受けていません。スイート全体を横断する広さと、スクリプトから扱える機械可読な出力を求める人のためのコミュニティツールです。名称、対象範囲、トレードオフを正面から比較した内容はacli と atlassian-cli の比較をご覧ください。

同じ Jira 操作を atlassian-cli で行う

オープンソースの atlassian-cli で同等の Jira 操作を行う例です。動詞は jira workitem ではなく jira issue の下にあり、JQL の書き方は同じです。

# Search with JQL
atlassian-cli jira issue search \
  --jql "project = DEV order by created desc" --limit 5

# View a single issue
atlassian-cli jira issue get DEV-123

# Create a Task
atlassian-cli jira issue create \
  --project DEV --issue-type Task --summary "Test task"

# Assign and transition
atlassian-cli jira issue assign DEV-123 --assignee user@example.com
atlassian-cli jira issue transition DEV-123 --transition "In Progress"

オープンソース側が重視しているのは、一括操作の安全性とスクリプトからの扱いやすさです。一括操作にはプレビュー用のフラグがあり、実行を確定する前に影響範囲を確認できます。

# Preview a mass transition before running it for real
atlassian-cli jira bulk transition \
  --jql "project = DEV AND status = Open" \
  --transition "In Progress" \
  --dry-run

また、すべてのコマンドがグローバルな --format フラグ（table、json、csv、yaml、quiet、markdown）を受け付けるため、他のツールへパイプでつなぐのが簡単です。

# Pull issue keys as JSON and hand them to jq
atlassian-cli jira issue search \
  --jql "project = DEV" --format json | jq '.[].key'

スプリント、プロジェクト、フィールド、ワークフロー、一括エクスポートを含むコマンドの全体像はコマンドリファレンスにまとまっています。

acli とオープンソース CLI の比較

どちらのツールもターミナルから Jira を操作します。違いは、誰が保守しているか、対象範囲がどこまで広がるか、どのライセンスかという点です。以下の表は、ベンチマークではなく確認できる事実だけをまとめています。

どちらの列が一般論として「優れている」ということはありません。acli は Atlassian 自身のツールと、そのサポート、Rovo Dev のような統合機能をもたらします。atlassian-cli はオープンソースであること、製品をまたぐ広さ、パイプでつなげる Unix 風の出力をもたらします。本当に必要なのが Jira の REST API なら、コマンドラインから Jira API を使うガイドでエンドポイントを直接叩く方法を解説しています。

どちらを使うべきか

短い判断の目安です。

• acli を選ぶのは、Atlassian の公式ツール、ベンダーサポート、ボードやスプリントを含む Jira の広いカバレッジ、あるいは Rovo Dev が必要な場合です。Atlassian 製品中心の環境で Jira だけを自動化するなら、無難な既定の選択肢です。
• atlassian-cli を選ぶのは、Confluence、Bitbucket、JSM も扱える MIT ライセンスの単一バイナリが欲しい場合です。ドライランに対応した一括操作と、パイプラインや CI で使える JSON、CSV、YAML の出力が揃っています。
• 両方を使うのも有効です。別々のツールなので競合しません。対話的な Jira 操作には公式 CLI を、製品をまたぐスクリプトにはオープンソースの CLI を使っているチームは少なくありません。

並べて示す目的は勝者を決めることではなく、それぞれのツールを正確に呼び分けることです。acli は Atlassian のものであり、atlassian-cli は独立したオープンソースです。どちらがどちらかを知っていれば、「acli jira」で検索したときに間違ったものをインストールせずに済みます。

よくある質問

関連リソース