Backlog CLI

特徴

108 コマンド

課題、PR、Wiki、ドキュメント、通知、Webhook、チーム管理など、Backlog API の主要な機能を 108 のコマンドでカバーしています。

gh CLI ベースの操作体系

list・view・create・edit を基本とした、gh CLI に倣ったコマンド構成です。

スクリプタブルな出力

--json フラグで JSON を出力できます。jq と組み合わせたり、CI/CD パイプラインに組み込めます。

AI エージェント連携

Agent Skill を導入すると、Claude Code や Cursor などの AI エージェントから Backlog を操作できます。

こんな使い方ができます

課題を一覧表示する

backlog issue list --project MY_PROJECT --assignee @me

#    種別    優先度  担当者        件名
123  タスク  中      yamada        API エンドポイントの設計
124  バグ    高      tanaka        ログインページの表示崩れ
125  タスク  低      suzuki        README の更新

課題を作成する

backlog issue create --project MY_PROJECT \
  --title "新機能: ダークモード対応" \
  --type タスク \
  --priority 中 \
  --assignee yamada

プルリクエストの状態を確認する

backlog pr status --project MY_PROJECT --repo my-app

オープン
#42  ダークモード対応       feature/dark-mode → main
#39  パフォーマンス改善     fix/perf → main

マージ済み
#38  認証フローのリファクタ refactor/auth → main

ダッシュボードで全体を把握する

backlog dashboard

自分の課題 (3件)
  MY_PROJECT-123  API エンドポイントの設計     処理中
  MY_PROJECT-130  テストカバレッジの改善       未対応
  MY_PROJECT-142  ドキュメントの整備           未対応

未読通知 (2件)
  MY_PROJECT-124  tanaka がコメントしました
  MY_PROJECT-138  PR がマージされました

JSON 出力でスクリプトと連携する

# 高優先度の課題だけを抽出
backlog issue list --project MY_PROJECT --json | jq '[.[] | select(.priority.name == "高")]'

# 課題キーの一覧を取得してループ処理
backlog issue list --project MY_PROJECT --json | jq -r '.[].issueKey' | while read key; do
  echo "Processing $key"
done

AI エージェントから使う

skills CLI で AI エージェント向けのスキルを追加すると、自然言語で Backlog 操作を指示できます。

npx skills add simochee/backlog-cli

「PROJ-123 を処理中にして」「自分の未完了課題を一覧して」といった自然言語の指示を、エージェントが適切な backlog コマンドに変換して実行します。詳しくは AI エージェント連携ガイドをご覧ください。

クイックスタート

インストール

npx nypm install -g @simochee/backlog-cli

認証
Terminal window
```
backlog auth login
```
対話形式でホスト名と認証方式（API キーまたは OAuth）を設定します。

使ってみる

backlog issue list --project YOUR_PROJECT

さらに詳しく

インストールパッケージマネージャーごとのインストール手順

クイックスタート認証の設定と基本的なコマンドの使い方

コマンドリファレンス全 108 コマンドの詳細なリファレンス

AI エージェント連携 Claude Code や Cursor から Backlog を操作する