出力とフォーマット

テーブル出力

bee のリスト系コマンドは、デフォルトで人間が読みやすいテーブル形式で出力します。

bee issue list --project MY_PROJECT

出力例:

ID           種別   優先度   担当者          件名
PROJECT-1    タスク  中      田中太郎        ドキュメントを更新する
PROJECT-2    バグ    高      鈴木花子        ログインエラーの修正
PROJECT-3    タスク  低      —              CI パイプラインの設定

JSON 出力

--json フラグを付けると、JSON 形式で出力されます。スクリプトや他のツールとの連携に便利です。

bee issue list --project MY_PROJECT --json

フィールドの絞り込み

--json にフィールド名をカンマ区切りで指定すると、出力するフィールドを絞り込めます。

bee issue view PROJECT-123 --json id,summary,status

ノート

利用可能なフィールド名は、--json（フィールド名なし）で出力した JSON のトップレベルキーです。

jq との組み合わせ

JSON 出力を jq と組み合わせると、柔軟なデータ加工ができます。

# 課題のサマリーだけを取り出す
bee issue list --project MY_PROJECT --json | jq '.[].summary'

# 優先度が「高」の課題だけを抽出
bee issue list --project MY_PROJECT --json | jq '[.[] | select(.priority.id == 2)]'

# 優先度が「高」の課題数をカウント
bee issue list --project MY_PROJECT --json | jq '[.[] | select(.priority.id == 2)] | length'

# 担当者ごとの課題数
bee issue list --project MY_PROJECT --json | jq 'group_by(.assignee.name) | map({name: .[0].assignee.name, count: length})'

パイプラインの活用

bee の出力を他のコマンドと組み合わせる例です。

# 課題キーの一覧をファイルに出力
bee issue list --project MY_PROJECT --json | jq -r '.[].issueKey' > issues.txt

# 複数の課題を一括クローズ
cat issues.txt | xargs -I {} bee issue close {}