atlassian-cli

Atlassian CLI (acli)

acli を使用して、ターミナルから Atlassian Cloud のワークフロー（Jira、Admin、Rovo Dev）を自動化し、操作できます。

ワークフロー

1. acli をインストールまたはアップグレードします（OS に応じた方法を選択してください）。
2. 認証します（トークン、OAuth、管理者 API キーから選択してください）。
3. acli help ... と --help で、正確なコマンドやフラグを確認します。
4. 自動化には機械可読な出力（--json）を優先し、jq で解析します。
5. 一括操作では、適切に --ignore-errors を使用します。予期しないエラーが発生した場合は、トレース ID を記録します。

判断フロー

インストール／アップグレード

Which OS?
  macOS:
    - Preferred: Homebrew
    - Fallback: download binary + put on PATH
  Linux:
    - Preferred: apt (Debian/Ubuntu) or yum (RHEL/CentOS)
    - Fallback: download binary to /usr/local/bin or ~/.local/bin
  Windows:
    - Download acli.exe via PowerShell (Invoke-WebRequest)
Upgrade:
  - Homebrew: brew upgrade acli
  - apt/yum: upgrade package
  - binary installs: re-download and replace

正確なコマンドについては、references/install.md を参照してください。

認証

What are you trying to access?
  Jira Cloud:
    - API token (non-interactive, CI-friendly)
    - OAuth (interactive): acli jira auth login --web
  Atlassian Admin (org admin):
    - API key (admin commands)
  Rovo Dev:
    - API token login, then: acli rovodev run

正確なログインコマンドについては、references/auth.md を参照してください。

シークレットの取り扱い（デフォルトで実施）

• トークンやキーをコマンドラインに直接指定しないでください。
• シークレットストアや CI のシークレット変数から標準入力に渡す方法を優先してください。
• トークンやキーをログ、差分、チャットの記録に出力しないでください。

コマンドの確認方法

• トップレベルのヘルプを表示します：acli --help
• 製品のヘルプを表示します：acli jira --help、acli admin --help、acli rovodev --help
• 詳細なヘルプを表示します：acli jira workitem create --help
• コマンドの場所がわからない場合は、acli help [path] を使用します。

自動化のパターン

• 後続の手順を成功時にのみ実行するには、コマンドを && でつなぎます。
• 表形式の出力（--csv）をファイルにリダイレクトします。
• --json | jq ... を使用して、特定のフィールドを抽出します。

references/automation.md を参照してください。

シェル補完

bash／zsh／fish／powershell で補完を有効にします。

references/shell-completion.md を参照してください。

トラブルシューティング

• サポートチケットに備えて、予期しないエラーからトレース ID を記録します。
• 一部の処理が成功すればよい一括操作では、--ignore-errors を使用します。
• JSON を使ったワークフローに対応しているコマンドでは、--generate-input-json／--generate-json を使用します。

references/troubleshooting.md を参照してください。

参考資料

• references/install.md
• references/auth.md
• references/automation.md
• references/shell-completion.md
• references/troubleshooting.md