Jira CLI コマンドチートシート

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

このチートシートは、atlassian-cli で使えるすべての Jira CLI コマンドを扱います。どのコマンドもコピーしてすぐ使えます。プレースホルダーの値（DEV-123、user@example.com）はご自身のものに置き換えてください。文脈まで含めた解説は Jira CLI ツール完全ガイドを、対応しているコマンドの一覧は Jira CLI のリファレンスをご覧ください。

認証

プロファイルを設定し、認証情報を管理します。先に id.atlassian.com で API トークンを発行してください。

認証情報は ~/.atlassian-cli/config.yaml に AES-256-GCM で暗号化して保存されます。どのコマンドでも --profile フラグを付ければ、特定のインスタンスを対象にできます。

課題の検索

JQL（Jira Query Language）を使って課題を検索します。どの検索にも --format json を付ければ、機械可読な出力が得られます。

課題の CRUD

個々の課題を作成、取得、更新、削除します。

遷移と担当者の割り当て

課題をワークフローのステータス間で動かし、担当者を管理します。

コメントとウォッチャー

コメントを追加し、課題のウォッチャーを管理します。

一括操作

コマンド 1 つで、数百件から数千件の課題を処理します。一括コマンドはすべて --dry-run に対応しており、実行前に変更内容をプレビューできます。

一括操作は並列に実行され、レート制限の処理を内蔵しています。--dry-run フラグは欠かせません。破壊的な変更は、確定する前に必ずプレビューしてください。

プロジェクトと管理

Jira の設定を確認します。プロジェクト、フィールド、ワークフロー、コンポーネント、バージョン、ロールを扱えます。

出力形式

すべてのコマンドは --format フラグで複数の出力形式に対応しています。用途に合った形式を選んでください。

スクリプトで出力をパイプする例です。

# Get issue keys and pipe to another command
atlassian-cli jira issue search \
  --jql "project = DEV AND status = Open" \
  --format quiet

# Export to JSON and filter with jq
atlassian-cli jira issue search \
  --jql "project = DEV" \
  --format json | jq '.[].key'

# Export issues to CSV for a spreadsheet
atlassian-cli jira bulk export \
  --jql "project = DEV" \
  --output issues.csv \
  --format csv

関連リソース