JQL クエリチートシート（2026年版）

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

JQL クエリとは、フィールドと値を照合して課題を探す Jira Query Language の式です。どのクエリも形は同じで、フィールド、演算子、値の 3 つからなります。たとえば status = Done です。句は AND、OR、NOT でつなぎ、ORDER BY で並べ替えます。このページは純粋なリファレンスです。必要な演算子、キーワード、関数、フィールドを 1 か所にまとめ、Jira の検索バーやコマンドラインの atlassian-cli にそのまま貼り付けられる例を添えています。

ブックマークしておくと便利です。チュートリアルや意見で水増ししてはいません。ターミナルからの検索を作業別に追いたい場合は、末尾にリンクした関連記事をご覧ください。~ の働きや closedSprints() の挙動を思い出したいだけなら、このまま読み進めてください。

JQL クエリ構文のあらまし

JQL クエリは、論理演算子でつないだ 1 つ以上の句と、任意で続く並べ替えからなります。SQL ではありません。SELECT も FROM も結合もなく、対象は常に課題です。

# field    operator   value
project    =          DEV

# two clauses joined with AND, then sorted
project = DEV AND status = "In Progress" ORDER BY priority DESC

次のいくつかのルールを守るだけで、デバッグの手間のほとんどが減ります。

• 空白や予約語を含む値は引用符で囲みます（status = "In Progress"）。
• キーワードと演算子は大文字小文字を区別しません（AND は and と同じ）が、フィールド名と値の名前は Jira の表記に合わせてください。
• ORDER BY は必ず最後、すべての絞り込み句の後に置きます。
• 括弧で論理をまとめます（(priority = High OR priority = Highest) AND status != Done）。

演算子

演算子はフィールドと値を比較します。比較演算子はほとんどのフィールドで使えます。テキスト演算子の ~ は自由記述のフィールドでのみ使えます。履歴演算子（WAS、CHANGED）は、フィールドが過去にどうなっていたかを検索します。

最もよくある間違いは、テキストのフィールドに = を使ってしまうことです。summary = "login" は、要約がちょうど login という語だけの課題にしか一致しません。login を含む要約をすべて探すには summary ~ "login" を使います。履歴演算子（WAS、WAS IN、CHANGED）は、AFTER、BEFORE、ON、DURING、BY、FROM、TO の述語でさらに絞り込めます。

キーワードと論理演算子

キーワードは句をつなぎ、並び順を制御します。あらゆる JQL クエリをつなぐ結合組織のような存在です。

未解決の課題を表すなら、status != Done ではなく resolution = EMPTY（または resolution IS EMPTY）が最適です。ステータス名はワークフローごとに異なりますが、resolution フィールドは課題が本当にクローズされた時点で設定されるため、「まだ open か」を問う移植性の高い方法になります。

関数

関数は、Jira がクエリ実行時に評価する動的な値を生成します。保存したフィルターが使われ続けるのはこの仕組みのおかげです。assignee = currentUser() は実行する人ごとに異なる意味になり、sprint IN openSprints() はその日に進行中のスプリントを常に指し続けます。

スプリント関数は、スプリントを使うボードにのみ適用されます。バージョン関数は、どのリリース計画を読むかを Jira に伝えるためにプロジェクトキーを引数に取ります。すべての関数は、引数がない場合でも now() のように括弧を付けて呼び出します。

よく使うフィールド

最もよく参照するフィールドを挙げます。カスタムフィールドは名前か cf[10010] 形式の識別子で検索します。自分のインスタンスの ID を調べるには atlassian-cli jira fields list を実行してください。

日付での絞り込み

日付フィールドは、絶対値（"2026-07-01"）、相対の省略記法、関数を受け付けます。最も手早く書けるのは相対の省略記法で、符号付きの数値の後ろに単位を付けます。負の値は現在から過去にさかのぼります。

m は月ではなく分を意味します。ここは絶えず誤解される点です。暦に合わせた期間には、代わりに境界関数を使ってください。created >= startOfMonth() は月初以降のすべてを、due <= endOfWeek() は実行する曜日にかかわらず今週の残りを対象にします。

そのまま使えるクエリ例

繰り返し発生する用途向けの具体的なクエリです。DEV をご自身のプロジェクトキーに置き換えて、JQL クエリを受け付ける場所であればどこでも実行できます。

コマンドラインから JQL を実行する

このチートシートの JQL クエリは、いずれもそのまま atlassian-cli で実行できます。クエリを jira issue search の --jql フラグに渡し、次に行う作業に合った出力形式を選んでください。

# Basic search, table output
atlassian-cli jira issue search --jql "project = DEV AND status = 'In Progress'"

# My open work, most urgent first, top 20
atlassian-cli jira issue search \
  --jql "assignee = currentUser() AND resolution = EMPTY order by priority desc" \
  --limit 20

# Export recent bugs to CSV
atlassian-cli jira issue search \
  --jql "project = DEV AND type = Bug AND created >= -30d" \
  --format csv --output recent-bugs.csv

# Pipe JSON into jq to pull just the issue keys
atlassian-cli jira issue search \
  --jql "sprint IN openSprints() AND status != Done" \
  --format json | jq '.[].key'

同じ JQL で一括操作も実行できます。まず --dry-run でプレビューし、外して実行すると、一致したすべての課題に適用されます。

# Close stale in-review tickets (preview first)
atlassian-cli jira bulk transition \
  --jql "project = DEV AND status = 'In Review' AND updated < -14d" \
  --transition "Done" \
  --dry-run

特定のサイトを対象にするには --profile <name> を追加してください。フラグの全一覧はコマンドリファレンスにあります。すべてのコマンドグループが --format table|json|csv|yaml|quiet|markdown を受け付けます。

Atlassian 自身の CLI との違い：atlassian-cli はコミュニティによる独立したオープンソースプロジェクトです。Atlassian が提供する公式 CLI（acli）ではありません。Atlassian と提携・関連しておらず、Atlassian による承認、推奨、後援、保守のいずれも受けていません。ベンダーによる一次サポートが必要なら公式の acli を使ってください。Jira、Confluence、Bitbucket、JSM をまたぐ無料の Rust バイナリを 1 つで済ませたい場合は atlassian-cli を使ってください。JQL の構文自体は、どのツールがクエリを送っても同じです。JQL は Jira のサーバー側で評価されるからです。

よくある質問

関連リソース