claude-skills/

Anthropic公式スキル・プラグインの日本語ディレクトリ

last sync 22h ago
スキルOfficialdevelopment

🔧boltz-cli-setup

プラグイン
boltz
ソース
GitHub で見る ↗

説明

Boltz CLIのセットアップと認証。 次のような場合に使用: `boltz-api` のインストール、更新、動作確認、または認証を行う場合、 あるいはCLIの欠落、PATH設定、サンドボックス、ブラウザログイン、認証エラーを修正する場合。

原文を表示

Boltz CLI setup and auth. Use when installing, updating, verifying, or authenticating `boltz-api`, or fixing missing CLI, PATH, sandbox, browser login, or auth errors.

ユースケース

  • ✓boltz-apiのインストール・更新を行うとき
  • ✓CLIの動作確認や認証を行うとき
  • ✓CLIの欠落やPATH設定を修正するとき
  • ✓ブラウザログインや認証エラーを修正するとき
  • ✓サンドボックス環境をセットアップするとき

本文（日本語訳）

Boltz CLI セットアップ

次のような場合に使用: boltz-api のインストール、バージョン、PATH、および認証に関する問題。 ワークフロー系のスキルは boltz-api が既にインストール済みであることを前提としています。

インストールの確認

CLI が利用可能かどうかを確認します:

boltz-api --version

boltz-api が見つからない、またはバージョンが古い場合は、公式 CLI リポジトリからインストールまたは更新してください。

macOS / Linux:

curl -fsSL https://install.boltz.bio/boltz-api/install.sh | sh

Windows PowerShell:

irm https://install.boltz.bio/boltz-api/install.ps1 | iex

インストーラーは、既存の boltz-api が PATH 上に存在する場合はそれを更新します。 バイナリが見つからない場合は、ユーザーローカルの bin ディレクトリにインストールされます。 インストール後も boltz-api --version が認識されない場合は、インストール先のバイナリを PATH に追加してください。

サンドボックスへの対処は非常に重要です。サンドボックス環境では、ブラウザログイン、OAuth コールバック、一時ファイル、認証情報のストレージ、およびユーザー全体のインストールパスがブロックされる可能性があります。 ユーザーが通常のインストールを求めている場合は、ユーザーの実際の環境で boltz-api のインストールまたは認証を行ってください。 ファイルシステムのサンドボックス内では、インストールや認証フローに必要なホストサンドボックスのバイパス／昇格を要求してください。

インストーラー、ブラウザの自動起動、OAuth コールバック、認証情報のストレージ、一時ファイル、またはグローバルインストールパスが agent サンドボックスによってブロックされる場合は、references/sandbox.md を参照してください。

認証

現在の認証状態を確認するには:

boltz-api auth status

auth status が未認証を報告した場合、または認証が存在しないもしくは期限切れにより Boltz のコマンドが失敗した場合は、リトライの前にユーザーに代わってデバイスコードログインを開始してください:

boltz-api auth login --device-code

デバイスコードログインを開始する前にユーザーへの確認は不要です。 ログイン URL／コードを伝えて CLI の完了を待つことは、認証回復フローの一部です。 認証ログインの URL／コードをユーザーに案内する際は、boltz-api auth login --device-code を正確に実行するよう伝えてください。

認証回復の際は、CLI がブラウザを自動的に開けるものとして、上記のコマンドをそのまま実行してください。 サンドボックス環境では、ブラウザの自動起動、OAuth コールバック、認証情報のストレージ、または一時ファイルに必要なホストサンドボックスのバイパス／昇格を要求してください。

API キーが既に利用可能な自動化環境向けには、API キーによる認証も引き続きサポートされています:

export BOLTZ_API_KEY=<api-key>

バージョン確認

このスキル内で期待するコマンドや最小バージョンをハードコードしないでください。 CLI 自身の更新チェックを信頼できる情報源として扱ってください。

boltz-api が更新の利用可能または必須を報告した場合は、そのメッセージと CLI が提示するインストールコマンドをそのまま伝えてください。 CLI はこの情報を、Boltz がホストするバージョンメタデータエンドポイント（例: /cli/version）から取得する場合があります。 このエンドポイントは、最新バージョン、サポートされる最小バージョン、更新が必要かどうか、およびプラットフォームに応じたインストール手順を返します。

CLI が古いと判断される理由をユーザーに尋ねられた場合は、次の使い分けを説明してください:

  • GitHub Releases — インストール可能な CLI バイナリの種類を定義します。
  • Boltz バージョンエンドポイント — API の互換性（サポートされる最小 CLI バージョンを含む）を定義します。

BOLTZ_API_NO_UPDATE_CHECK=1 などのユーザーまたは CI による更新チェックの無効化設定を尊重し、環境がそれを無効にしている場合は強制的に更新チェックを行わないでください。

原文（English）を表示

Boltz CLI Setup

Use this skill for boltz-api installation, version, PATH, and authentication issues. The workflow skills assume boltz-api is already installed.

Verify Installation

Check that the CLI is available:

boltz-api --version

If boltz-api is missing or too old, install or update it from the official CLI repo.

macOS and Linux:

curl -fsSL https://install.boltz.bio/boltz-api/install.sh | sh

Windows PowerShell:

irm https://install.boltz.bio/boltz-api/install.ps1 | iex

The installer updates an existing boltz-api on PATH. If no binary is found, it installs to a user-local bin directory. Add the installed binary to PATH if boltz-api --version is still not found after install.

Working around the sandbox is critical because the sandbox can block browser login, OAuth callbacks, temp files, credential storage, and user-wide install paths. If the user asks for a normal install, install or authenticate boltz-api in the user's real environment. In a filesystem sandbox, request the host sandbox bypass/escalation needed for the install or auth flow.

Read references/sandbox.md when an agent sandbox blocks the installer, browser auto-open, OAuth callback, credential storage, temp files, or global install path.

Authenticate

Check the current auth state with:

boltz-api auth status

If auth status reports unauthenticated, or any Boltz command fails because authentication is missing or expired, start device-code login on the user's behalf before retrying:

boltz-api auth login --device-code

Do not ask the user for permission before starting device-code login; relaying the login URL/code and waiting for the CLI to complete is part of auth recovery. When sharing the authentication login URL/code, tell the user to use exactly boltz-api auth login --device-code.

For auth recovery, assume the CLI can auto-open the browser and run the exact command above. In sandboxed environments, request the host sandbox bypass/escalation needed for browser auto-open, OAuth callbacks, credential storage, or temp files.

For automation where a key is already available, an API key is still supported:

export BOLTZ_API_KEY=<api-key>

Version Checks

Do not hard-code expected commands or minimum versions in this skill. Treat the CLI's own update check as the source of truth.

When boltz-api reports that an update is available or required, relay that message and the install command it provides. The CLI may get this from a Boltz-hosted version metadata endpoint such as /cli/version, returning latest version, minimum supported version, whether an update is required, and platform-appropriate install instructions.

If a user asks why the CLI thinks it is stale, explain the split:

  • GitHub Releases define which CLI binaries are available to install.
  • The Boltz version endpoint defines API compatibility, including the minimum supported CLI version.

Respect user or CI opt-outs such as BOLTZ_API_NO_UPDATE_CHECK=1; do not force update checks when the environment disables them.

原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。