Jira CLI

jira-cli を使用して、Atlassian Jira をコマンドラインから操作します。

使用する場合

• ユーザーが Jira イシュー/チケットの作成、閲覧、編集、検索をリクエストする
• ユーザーがワークフロー状態を通じてイシューを遷移させる必要がある (To Do → In Progress → Done)
• ユーザーがスプリント、エピック、またはボードを管理したい
• ユーザーがイシューの割り当て、コメント追加、または作業時間のログが必要
• ユーザーが現在のタスクやスプリント進捗について質問する

前提条件

1. jira-cli をインストール: brew install ankitpokhrel/jira-cli/jira-cli (macOS) または releases からダウンロード
2. API トークンを設定: export JIRA_API_TOKEN="your-token"
3. 初期化: jira init を実行し、プロンプトに従う

イシューコマンド

イシュー一覧表示

# 現在のプロジェクトのイシューを一覧表示
jira issue list

# 自分に割り当てられたイシューを一覧表示
jira issue list -a$(jira me)

# ステータスでフィルタリングしたイシューを一覧表示
jira issue list -s"In Progress"

# 高優先度のイシューを一覧表示
jira issue list -yHigh

# 複数のフィルターで一覧表示
jira issue list -a$(jira me) -s"To Do" -yHigh --created week

# 生の JQL で一覧表示
jira issue list -q "project = PROJ AND status = 'In Progress'"

# スクリプト用のプレーンテキスト出力
jira issue list --plain --columns key,summary,status --no-headers

イシュー作成

# インタラクティブなイシュー作成
jira issue create

# すべてのオプションを指定して作成
jira issue create -tBug -s"Login button not working" -b"Description here" -yHigh --no-input

# ストーリーを作成
jira issue create -tStory -s"Add user authentication" -yMedium

# ラベルとコンポーネント付きで作成
jira issue create -tTask -s"Update dependencies" -lmaintenance -l"tech-debt" -Cbackend

# 作成して自分に割り当て
jira issue create -tBug -s"Fix crash on startup" -a$(jira me) --no-input

イシュー閲覧

# イシューの詳細を表示
jira issue view ISSUE-123

# コメント付きで表示
jira issue view ISSUE-123 --comments 10

# プレーンテキストで表示
jira issue view ISSUE-123 --plain

# ブラウザでイシューを開く
jira open ISSUE-123

イシュー編集

# サマリーを編集
jira issue edit ISSUE-123 -s"Updated summary"

# 説明を編集
jira issue edit ISSUE-123 -b"New description"

# 優先度を編集
jira issue edit ISSUE-123 -yHigh

# ラベルを追加
jira issue edit ISSUE-123 -lnew-label

イシュー遷移

# イシューを新しいステータスに移動
jira issue move ISSUE-123 "In Progress"

# コメント付きで移動
jira issue move ISSUE-123 "Done" --comment "Completed the task"

# 移動と解決策を設定
jira issue move ISSUE-123 "Done" -RFixed

イシュー割り当て

# 自分に割り当て
jira issue assign ISSUE-123 $(jira me)

# 特定のユーザーに割り当て
jira issue assign ISSUE-123 username

# 割り当てを解除
jira issue assign ISSUE-123 x

コメント

# コメントを追加
jira issue comment add ISSUE-123 "This is my comment"

# エディターからコメントを追加
jira issue comment add ISSUE-123

作業ログ

# 作業時間をログ
jira issue worklog add ISSUE-123 "2h 30m"

# コメント付きで作業時間をログ
jira issue worklog add ISSUE-123 "1d 4h" --comment "Completed feature implementation" --no-input

イシューのリンクと複製

# 2つのイシューをリンク
jira issue link ISSUE-123 ISSUE-456 Blocks

# イシューのリンクを解除
jira issue unlink ISSUE-123 ISSUE-456

# イシューを複製
jira issue clone ISSUE-123 -s"Cloned: New summary"

# イシューを削除
jira issue delete ISSUE-123

エピックコマンド

# エピック一覧表示
jira epic list

# テーブル形式でエピック一覧表示
jira epic list --table

# エピックを作成
jira epic create -n"Q1 Features" -s"Epic summary" -b"Epic description"

# エピックにイシューを追加
jira epic add EPIC-1 ISSUE-123 ISSUE-456

# エピックからイシューを削除
jira epic remove ISSUE-123 ISSUE-456

スプリントコマンド

# スプリント一覧表示
jira sprint list

# 現在のアクティブなスプリントを一覧表示
jira sprint list --current

# 現在のスプリントの自分のイシューを一覧表示
jira sprint list --current -a$(jira me)

# スプリントにイシューを追加
jira sprint add SPRINT_ID ISSUE-123 ISSUE-456

プロジェクトとボードコマンド

# プロジェクト一覧表示
jira project list

# ボード一覧表示
jira board list

# リリース/バージョン一覧表示
jira release list

# ブラウザでプロジェクトを開く
jira open

ユーティリティコマンド

# 現在のユーザー名を取得
jira me

# ヘルプを表示
jira --help
jira issue --help

# シェル補完をセットアップ
jira completion bash  # or zsh, fish, powershell

よく使われるフラグ

フラグ	説明
--plain	プレーンテキスト出力 (インタラクティブUI なし)
--raw	生の JSON 出力
--csv	CSV 出力
--no-input	インタラクティブプロンプトをスキップ
-t, --type	イシュータイプ (Bug, Story, Task, Epic)
-s, --summary	イシュータイトル
-b, --body	イシュー説明
-y, --priority	優先度 (Highest, High, Medium, Low, Lowest)
-l, --label	ラベル (繰り返し可能)
-a, --assignee	割り当てユーザー名
-r, --reporter	レポーターユーザー名
-C, --component	コンポーネント名
-P, --parent	親イシュー/エピックキー
-q, --jql	生の JQL クエリ
--created	作成日でフィルタリング (-7d, week, month)
--order-by	ソート フィールド
--reverse	ソート順序を反転

一般的なワークフロー

イシューで作業を開始

# 自分に割り当ててIn Progressに移動
jira issue assign ISSUE-123 $(jira me)
jira issue move ISSUE-123 "In Progress"

イシューを完了

# 作業時間をログして完了
jira issue worklog add ISSUE-123 "4h" --no-input
jira issue move ISSUE-123 "Done" --comment "Completed" -RFixed

日次スタンドアップレビュー

# 現在のスプリントのタスクを表示
jira sprint list --current -a$(jira me)

バグを作成して追跡

# バグを作成
jira issue create -tBug -s"App crashes on login" -yHigh -lbug --no-input
# 返されたイシューキーをメモして割り当て
jira issue assign BUG-123 $(jira me)
jira issue move BUG-123 "In Progress"

出力例

コマンド	ユースケース
jira issue list --plain	スクリプトフレンドリーな出力
jira issue list --raw	パース用の JSON
jira issue list --csv	スプレッドシートへのエクスポート

制限事項

• 事前の jira init 設定が必要
• 一部機能は Jira Cloud と Server で異なる可能性
• 複雑なカスタムフィールドは --custom フラグにフィールドID が必要な場合がある
• Jira インスタンスの設定に基づくレート制限が適用される