bkt

Bitbucket CLI（bkt）

Bitbucket Cloud および Data Center の操作には bkt を使用します。自動化では、構造化された --json、--yaml、--jq、または --template の出力を優先してください。

要求された操作から始める

インストールや互換性が不明な場合に限り、bkt --version を実行してください。認証が必要なコマンドを実行する場合、またはアクティブなプラットフォームとコンテキストが不明な場合は、bkt auth status を実行してください。すでに設定済みの読み取り専用の依頼では、セットアップを前提条件にしないでください。

Cloud と Data Center では利用できる機能が異なります。アクティブなコンテキストからプラットフォームを判断するか、推測できない場合は確認してください。Data Center で Cloud 専用コマンドを提案したり、その逆を行ったりしないでください。

インストール、認証、コンテキストの作成、または主なコマンドパターンを確認する場合は、セットアップと一般的なワークフローを参照してください。設定不要の CI やコンテナーについては、ヘッドレス認証を参照してください。

コマンドリファレンスを参照する

依頼されたコマンドグループのリファレンスだけを参照してください。

• プルリクエスト、リポジトリ、 ブランチ、コミット、または ステータス
• パイプラインまたは変数
• Bitbucket Cloud Issues は廃止されました（Atlassian が 2026 年 8 月に削除しました）。課題の追跡には Jira を使用してください。
• Data Center の管理、 プロジェクト、または権限
• 認証、コンテキスト、 ウェブフック、拡張機能、 MCP、スキル、または生の API

変更と認証情報に関する境界

• 一覧表示、閲覧、ステータス確認、チェックは読み取り専用です。作成、編集、承認、マージ、削除、再実行、権限変更は Bitbucket に変更を加えるため、ユーザーがその変更を依頼した場合にのみ実行してください。
• ログに記録されたり、コミットされたファイルに含まれたりする可能性のあるコマンドに、トークン、OAuth シークレット、パスワードを決して含めないでください。認証リファレンスに記載された、CLI がサポートする認証情報の利用方法または環境変数を使用してください。
• すべての bkt ビルドには Cloud のブラウザー OAuth コンシューマーが含まれているため、bkt auth login --kind cloud --web にセットアップは不要です。
• マージやその他の重大な書き込みを行う前に、対象、リポジトリ、現在のチェックを正確に確認してください。処理後は URL または識別子を報告してください。

リファレンス

• admin — Bitbucket の管理操作 (DC)
• auth — Bitbucket の認証情報を管理
• branch — ブランチを確認、管理
• commit — コミットを操作
• context — Bitbucket CLI のコンテキストを管理
• extension — bkt CLI 拡張機能を管理
• mcp — エージェント向け Model Context Protocol サーバー
• perms — Bitbucket の権限を管理 (DC)
• pipeline — Bitbucket Cloud のパイプラインを実行、確認 (Cloud)
• pr — プルリクエストを管理
• project — Bitbucket プロジェクトを操作 (DC)
• repo — Bitbucket リポジトリを操作
• skill — エージェントスキルをインストール、管理
• status — コミットとプルリクエストのステータスを確認
• variable — パイプライン変数を管理 (Cloud)
• webhook — Bitbucket ウェブフックを管理
• other — API