認証
Backlog CLIを使うには、まずBacklogスペースへの認証が必要です。APIキーとOAuth 2.0の2つの認証方式に対応しています。
API キー
Section titled “API キー”最もシンプルな認証方式です。Backlogの「個人設定 > API」ページからAPIキーを発行して使用します。
backlog auth login --method api-key対話形式でホスト名とAPIキーの入力を求められます。パイプでAPIキーを渡すことも可能です。
echo "YOUR_API_KEY" | backlog auth login --with-tokenOAuth 2.0
Section titled “OAuth 2.0”ブラウザベースの認証フローで、APIキーの手動管理が不要な認証方式です。
backlog auth login --method oauthブラウザが自動で開き、認証が完了するとトークンが保存されます。トークンの有効期限が切れた場合はリフレッシュできます。
backlog auth refresh認証状態の確認
Section titled “認証状態の確認”現在の認証状態を確認するには、次のコマンドを実行します。
backlog auth status特定のスペースの認証状態を確認したい場合は --space フラグを指定します。
backlog auth status --space your-space.backlog.comトークンの値を確認する場合は --show-token フラグを付けます。
backlog auth status --show-token複数スペースの管理
Section titled “複数スペースの管理”複数のBacklogスペースに認証し、切り替えながら使うことができます。
# スペース A に認証backlog auth login --space space-a.backlog.com
# スペース B に認証backlog auth login --space space-b.backlog.comデフォルトスペースの切り替え
Section titled “デフォルトスペースの切り替え”普段使うスペースを切り替えるには auth switch を使います。
backlog auth switch --space space-b.backlog.comコマンド実行時のスペース指定
Section titled “コマンド実行時のスペース指定”--space グローバルフラグを使うと、デフォルトスペースを変更せずに一時的に別のスペースを対象にできます。
backlog issue list --project PROJ --space space-b.backlog.comスペース解決の優先順位
Section titled “スペース解決の優先順位”Backlog CLIは次の優先順位でスペースを決定します。
--spaceフラグ /BACKLOG_SPACE環境変数 / 設定ファイルのdefaultSpace+ 設定ファイルの認証情報BACKLOG_API_KEY+BACKLOG_SPACE環境変数（フォールバック）
環境変数による認証（CI / AI エージェント向け）
Section titled “環境変数による認証（CI / AI エージェント向け）”backlog auth login を実行できない非インタラクティブ環境（CIパイプライン、AIエージェント等）では、環境変数だけで認証できます。
export BACKLOG_SPACE=your-space.backlog.comexport BACKLOG_API_KEY=your-api-key
# backlog auth login なしで利用可能backlog issue list --project YOUR_PROJECTCI環境でのセットアップの詳細は CI での利用ガイド を参照してください。
認証情報の保存場所
Section titled “認証情報の保存場所”認証情報は ~/.backlogrc ファイルに保存されます。環境変数 XDG_CONFIG_HOME が設定されている場合は $XDG_CONFIG_HOME/.backlogrc に保存されます。
設定ファイルの管理には rc9 を使用しています。
スペースの認証情報を削除するには auth logout を使います。
# デフォルトスペースからログアウトbacklog auth logout
# 特定のスペースからログアウトbacklog auth logout --space your-space.backlog.com