2026年の Jira CLI ツール完全ガイド

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

Jira CLI とは

Jira CLI（コマンドラインインターフェース）は、ターミナルから直接 Jira を操作できるツールです。課題を検索したり、課題を作成したり、ワークフローを遷移させたりするために Jira の Web UI をクリックして回る代わりに、atlassian-cli jira issue search --jql "project = DEV" のようなコマンドを実行すれば、結果がすぐに返ってきます。

Jira CLI ツールは、パイプラインでの課題作成を自動化したいDevOps エンジニア、複数プロジェクトにまたがる数千件の課題を管理するプラットフォームエンジニア、ブラウザでは何時間もかかる一括操作を行うJira 管理者に使われています。Jira とターミナルを行き来するワークフローであれば、Jira CLI はコンテキストスイッチをなくし、Web UI では実現できない自動化を可能にします。Jira CLI のコマンドリファレンスをすぐに見ることもできますし、このまま完全ガイドを読み進めることもできます。

コマンドラインから Jira を使う理由

Jira の Web UI は視覚的に閲覧するために設計されており、速度や自動化のためのものではありません。チームが Jira のコマンドラインツールに移行する理由は次のとおりです。

• 速度。ターミナルから JQL で課題を検索すると、1 秒もかからずに結果が返ります。ページの読み込みも、JavaScript の描画待ちもありません。コマンド 1 つが十数回のクリックを置き換えます。
• スクリプト化。シェルスクリプトで Jira のコマンドをつなげられます。放置された課題を検索し、遷移させ、コメントを追加し、Slack に通知する。これらをすべて 1 つのスクリプトで実行できます。Web UI では手作業の繰り返しなしには実現できません。
• CI/CD 連携。デプロイが失敗したときに Jira 課題を自動で作成できます。プルリクエストがマージされたら課題を「Done」へ遷移させ、ビルドのメタデータでカスタムフィールドを更新することもできます。Jira CLI ツールは GitHub Actions、GitLab CI、Jenkins に直接組み込めます。
• 大規模な一括操作。プロジェクトの整理で 500 件の課題を「In Progress」から「Done」へ遷移させたいときは、jira bulk transition コマンド 1 つで、並列実行とレート制限に配慮しながら処理できます。ブラウザなら 500 回の個別クリックです。
• 機械可読な出力。課題データを JSON、CSV、YAML で取得できます。jq にパイプしてフィルタリングしたり、スプレッドシートにエクスポートしたり、別のツールに渡したりできます。Jira CLI は Jira を自動化基盤のデータソースに変えます。

主要な Jira CLI ツールの比較

2026年には複数の Jira CLI ツールが存在し、それぞれ得意分野が異なります。率直に比較すると次のようになります。

atlassian-cli は、4 つの Atlassian 製品を 1 つのバイナリでカバーする唯一のオープンソースツールです。Rust で書かれており、ランタイム依存のないネイティブ実行ファイルにコンパイルされます。プロファイル機能により、複数の Atlassian インスタンス（dev、staging、prod）を 1 つの設定ファイルから管理できます。一括操作にはドライランモード、並列数の制御、レート制限の処理が含まれます。

ankitpokhrel/jira-cli は、Jira だけを使う場合の有力な選択肢です。対話的な課題ボード表示を備えた TUI（ターミナル UI）を搭載しており、ターミナル上で視覚的に閲覧したいときに便利です。Go で書かれており、高速で、よく保守されています。

go-jira はかつて最も広く使われた Jira CLI でしたが、現在はアーカイブされ、保守されていません。今も go-jira を使っているなら、保守が続いている代替ツールへの移行を検討する価値があります。

Appfire の CLI は、Jira や Confluence をはじめとする Atlassian 製品に対応する、エンタープライズ向けの Java 製 CLI です。強力ですが、有償ライセンスと Java ランタイムが必要です。すでに Appfire のエコシステムを使っている組織に向いています。

それぞれの選択肢をさらに詳しく突き合わせた比較は、Jira CLI ツール比較ガイドをご覧ください。

atlassian-cli を使い始める

インストール

お好みのインストール方法を選んでください。

# Homebrew (macOS / Linux)
brew tap omar16100/atlassian-cli
brew install atlassian-cli

# Cargo (Rust toolchain)
cargo install atlassian-cli

# Verify
atlassian-cli --version

macOS、Linux、Windows 向けのビルド済みバイナリを GitHub Releases ページからダウンロードすることもできます。

認証

CLI は認証に Atlassian の API トークンを使います。id.atlassian.com でトークンを作成し、プロファイルを設定してください。

# Add a profile with your Atlassian credentials
atlassian-cli auth login \
  --profile work \
  --base-url https://your-domain.atlassian.net \
  --email you@company.com \
  --token $ATLASSIAN_API_TOKEN \
  --default

# Verify authentication
atlassian-cli auth list

認証情報は ~/.atlassian-cli/config.yaml に AES-256-GCM 暗号化で保存されます。異なる Atlassian インスタンス（dev、staging、production）ごとに複数のプロファイルを管理し、--profile フラグで切り替えられます。

最初のコマンド

プロジェクト内の最近の課題を検索します。

atlassian-cli jira issue search --jql "project = DEV order by created desc" --limit 5

既定では整形されたテーブルが返ります。機械可読な出力には --format json を、スプレッドシート向けには --format csv を追加してください。

必須の Jira CLI コマンド

JQL で課題を検索する

JQL（Jira Query Language）は課題を探すうえで最も強力な方法です。jira issue search コマンドは有効な JQL 文字列であれば何でも受け付けます。

# Open bugs assigned to you
atlassian-cli jira issue search \
  --jql "assignee = currentUser() AND type = Bug AND status != Done"

# Issues updated in the last 24 hours
atlassian-cli jira issue search \
  --jql "project = DEV AND updated >= -1d" \
  --format json

# Unassigned issues in the current sprint
atlassian-cli jira issue search \
  --jql "sprint in openSprints() AND assignee is EMPTY"

課題を作成する

ターミナルから直接課題を作成できます。プロジェクト、課題タイプ、要約をフラグで指定します。

# Create a bug
atlassian-cli jira issue create \
  --project DEV \
  --issue-type Bug \
  --summary "Login page returns 500 on invalid email"

# Create a task
atlassian-cli jira issue create \
  --project DEV \
  --issue-type Task \
  --summary "Update API documentation for v2 endpoints"

課題を更新して遷移させる

ブラウザを開かずに、課題をワークフローに沿って進め、フィールドを更新できます。

# Transition an issue to "In Progress"
atlassian-cli jira issue transition DEV-123 --transition "In Progress"

# Update the summary
atlassian-cli jira issue update DEV-123 --summary "Updated: Login page error handling"

# Assign to a team member
atlassian-cli jira issue assign DEV-123 --assignee user@example.com

課題の詳細を表示する

ステータス、担当者、説明を含め、任意の課題の詳細をすべて取得できます。

# Get issue details
atlassian-cli jira issue get DEV-123

# JSON output for scripting
atlassian-cli jira issue get DEV-123 --format json

プロジェクト、フィールド、ワークフロー

Jira の設定を確認して、利用できるプロジェクト、カスタムフィールド、ワークフローのステータスを把握できます。

# List all projects
atlassian-cli jira project list

# List custom fields
atlassian-cli jira fields list

# List workflows and their transitions
atlassian-cli jira workflows list

一括操作（応用）

一括操作は、Jira CLI ツールが Web UI を大きく上回る領域です。jira bulk サブコマンドを使えば、数百件から数千件の課題を 1 つのコマンドで処理できます。

一括遷移

一致するすべての課題を新しいステータスへ遷移させます。--dry-run フラグを付けると、実行を確定する前に変更内容をプレビューできます。

# Preview: see which issues would be transitioned
atlassian-cli jira bulk transition \
  --jql "project = DEV AND status = 'In Progress'" \
  --transition "Done" \
  --dry-run

# Execute the transition for real
atlassian-cli jira bulk transition \
  --jql "project = DEV AND status = 'In Progress'" \
  --transition "Done"

一括割り当てとエクスポート

# Assign all unassigned issues to a team member
atlassian-cli jira bulk assign \
  --jql "project = DEV AND assignee is EMPTY" \
  --assignee admin@example.com

# Export all issues to JSON for backup or analysis
atlassian-cli jira bulk export \
  --jql "project = DEV" \
  --output issues.json \
  --format json

一括操作は並列実行と組み込みのレート制限の処理を備えているため、スロットリングに達することなく Atlassian Cloud の API に対して安全に動作します。ドライランフラグにより、破壊的な変更を適用する前に必ずプレビューできます。

CI/CD 連携

Jira CLI は CI/CD パイプラインに直接組み込めます。認証には環境変数を設定し、機械可読な出力には --format json を使います。

GitHub Actions の例

# .github/workflows/jira-update.yml
name: Update Jira on Deploy
on:
  push:
    branches: [main]

jobs:
  update-jira:
    runs-on: ubuntu-latest
    steps:
      - name: Install atlassian-cli
        run: cargo install atlassian-cli

      - name: Transition deployed issues
        env:
          ATLASSIAN_CLI_BASE_URL: ${{ secrets.ATLASSIAN_BASE_URL }}
          ATLASSIAN_CLI_EMAIL: ${{ secrets.ATLASSIAN_EMAIL }}
          ATLASSIAN_CLI_TOKEN_DEFAULT: ${{ secrets.ATLASSIAN_TOKEN }}
        run: |
          atlassian-cli jira bulk transition \
            --jql "project = DEV AND status = 'Ready for Deploy'" \
            --transition "Done" \
            --format json

同じパターンは GitLab CI や Jenkins など、シェルコマンドを実行できるあらゆるパイプラインランナーで使えます。機械可読な JSON 出力により、結果を解析して後続のステップに渡せます。

よくある質問

関連リソース