# Stripe Projects CLI

サードパーティーサービスをアプリに追加し、認証情報をプロジェクトに同期して、アップグレードを管理します。

詳細については、[Stripe CLI リファレンス](https://docs.stripe.com/cli.md)を参照してください。

Stripe Projects は、ターミナルからサードパーティーサービス (ホスティング、データベース、認証、AI、可観測性など) をプロビジョニングして管理します。1 つのコマンドを実行するだけで、アカウントを作成し、認証情報を `.env` に同期し、Stripe を通じて請求を処理できます。

- **サービスをプロビジョニング**: [30 以上のプロバイダー](https://docs.stripe.com/projects.md#available-providers)から利用できます。個別のダッシュボードは不要です。
- **認証情報を自動的に同期**: `.env` に同期します。API キーをコピーして貼り付ける必要はありません。
- CLI またはコーディングエージェントからプラン、請求、環境、キーを**管理**。

## コーディングエージェントから始める

Claude Code、Cursor、Codex、または任意の MCP 対応コーディングエージェントに Stripe Projects スキルをインストールします。

```bash
npx skills add https://docs.stripe.com --skill stripe-projects -g -y
```

次に、必要なスタックをエージェントに伝えます。

```
"Use Stripe Projects to set up a Next.js app with Supabase, Vercel, and PostHog."
```

エージェントは CLI プラグインをインストールし、`stripe projects init` を実行して、サービスを追加し、認証情報を自動的に同期します。

## クイックスタート

プラグインをインストールし、プロジェクトを作成して、サービスを追加し、認証情報をローカル環境に取得します。

```bash
stripe plugin install projects
stripe projects init
stripe projects add supabase/project
stripe projects add vercel/project
stripe projects env --pull
```

## 仕組み

Stripe プロジェクトは 1 つのアプリケーションまたはコードベースを表し、プロバイダーアカウントのサービスとリソースをグループ化します。

- **プロバイダーアカウント**: Vercel、Supabase、Clerk、PostHog などのプロバイダーのアカウント。
- **サービス**: データベース、認証・認可、分析などのプロバイダーの製品。
- **リソース**: アカウント用サービスのインスタンスと、それに関連付けられた認証情報および環境変数 (例: `test-db-1`、`auth`、`test-analytics-1`)

プロジェクトを使用して、以下を実行できます。

- 既存のプロバイダーアカウントを関連付けるか、新しいアカウントを作成する
- データベース、認証・認可インスタンス、分析プロジェクトなどのリソースをプロビジョニングする
- 認証情報をボールトに格納し、環境変数として環境 (`.env`) に同期する
- `development`、`staging`、`production` などの名前付き環境を管理します。各環境には独自の出力ファイルとリソースのセットがあります。
- アップグレードの管理と認証情報のローテーション

プロバイダーアカウントを Stripe アカウントに関連付けると、明示的に関連付けを削除するまで、認可されたままになります。同じ Stripe アカウントでは、新しいプロジェクトでもそのプロバイダーアカウントを再利用できます。別の Stripe アカウントを使用する場合は、プロバイダーアカウントを再度関連付ける必要があります。

新しいディレクトリまたは既存のコードベースでプロジェクトを初期化できます。既存のコードベースを使用してサービスを追加すると、新しい認証情報と環境変数は既存の環境 (`.env`) およびプロジェクト設定にマージされます。

## 認証情報の仕組み

Stripe Projects は、お客様に代わって各プロバイダーから認証情報を取得し、`.projects/vault/vault.json` に暗号化して、Stripe の [Secret Store](https://docs.stripe.com/stripe-apps/store-secrets.md) に保存します。

- **ローカルファイル**: `.projects/vault/vault.json` には、認証情報の暗号化されたコピーが保存されます。`.env` はローカル開発用のデフォルトの出力ファイルです。名前付き環境では、CLI は `.env.dev` や `.env.production` など、設定された出力ファイルに書き込みます。CLI は `600` 権限で出力ファイルを作成するため、マシン上でそのファイルを読み取れるのは自分だけです。認証情報ファイルはバージョン管理にコミットしないでください。`stripe projects init` により、それらは `.gitignore` に自動的に追加されます。
- **削除時**: `stripe projects remove<service>` を実行すると、リソースのプロビジョニングが解除され、プロジェクトの状態から削除されます。CLI は、以前に`.env` または `.projects/vault/` に書き込まれた認証情報を削除しません。これらは手動で削除するか、`stripe projects env --pull` を実行して現在の認証情報セットで上書きしてください。

本番環境のホスティング環境で認証情報を使用するには、[本番環境の環境変数の設定](https://docs.stripe.com/projects.md#production-env)を参照してください。

## プロジェクトを作成する

プロジェクトに使用するディレクトリで `init` を実行します:

```bash
stripe projects init [name]
```

これにより、そのディレクトリの Stripe プロジェクトが初期化されます。名前を省略すると、Stripe Projects はフォルダ名を使用します。

Stripe Projects は、`.projects/`の下にプロジェクトの状態を書き込みます。これにより、関連付けられたプロバイダーアカウント、プロビジョニングされたリソース、ローカルのプロジェクト構成が追跡されます。プロジェクトで使用されるツールは、`.projects/state.json` で確認できます。プライベートリポジトリの `.projects/state.local.json` ファイルには、チームが同じプロジェクト状態を共有するために必要なリソース ID が含まれています。

### ファイル参照

| ファイルまたはフォルダ        | 目的                                                                                             | バージョン管理へのコミット要否               |
| ------------------ | ---------------------------------------------------------------------------------------------- | ----------------------------- |
| `state.json`       | チームが使用するサービス、リソース、環境定義、出力ファイルパス、および設定に関する共有プロジェクト状態。                                           | はい                            |
| `state.local.json` | ローカルでの上書きとマシン固有の設定。プロジェクトリソースと個人のプロバイダーアカウント、バックエンドリソース ID、およびこのマシンで選択されたアクティブな環境との関連付けを保存します。 | あり1                           |
| `.projects/vault/` | プロビジョニング後または `env --pull` の実行後に CLI によって書き込まれる暗号化された認証情報キャッシュ。                                 | いいえ、`.gitignore` に自動的に追加されます2 |
| `.projects/cache/` | パフォーマンス向上のために使用される CLI メタデータキャッシュ。                                                             | いいえ、`.gitignore` に自動的に追加されます  |
| `.env`、`.env.*`    | アクティブな環境に対して `env --pull` が書き込む、ローカル開発用の平文の認証情報。                                               | いいえ、`.gitignore` に自動的に追加されます  |

1 `.local` という命名規則ですが、`state.local.json` は引き続きコミットします。このファイルには、プロジェクトリソースと各自のプロバイダーアカウントの関連付けが保存されます。チームメイトが自分のアカウントを `stripe projects link` で正しく関連付けるには、このファイルが必要です。これをバージョン管理から除外すると、チームメイトが関連付けを行おうとしたときにエラーが発生します。アクティブな環境は各チームメイトの決済ごとにローカルで管理されるため、環境を切り替えても他のチームメイトのアクティブな環境は変わりません。

2これは共有シークレット配布システムではなく、ローカルの認証情報キャッシュです。各チームメイトは各自のマシンで `stripe projects env --pull` を実行し、Stripe Secret Store から自分用の認証情報を取得します。

## コーディングエージェントを使用する

プロジェクトを初期化すると、Stripe Projects はコーディングエージェントのスキルをローカルのプロジェクトディレクトリに書き込みます。これらのスキルは、Stripe Projects ワークフローを通じてエージェントがプロジェクトを操作するためのコンテキストとアクションを提供します。

エージェントには、以下のようなタスクの完了を依頼できます。

- 「既存の Neon アカウントをリンクし、データベースをプロビジョニングします。」
- 「無料ティアで Turso 認証・認可と PostHog を追加する」
- 「このリポジトリに必要なサービスを設定し、変更内容を説明する」

エージェントは同じ Stripe Projects CLI コマンドを使用します。CLI を直接使用する場合と同じ、決定論的で監査可能な経路で、認証情報のプロビジョニング、アップグレード、設定、同期を行えます。

プロビジョニングと認証情報のやり取りの際にブラウザのポップアップを避けるには:

1. Stripe アカウントにログイン
2. `stripe projects link` を使用して、既存のプロバイダーアカウントを関連付けます (または新規作成します)。
3. `stripe projects billing add` を使用して決済手段を追加します。
4. エージェントセッションを開始します。

## プロジェクトステータスの確認

サービスの追加またはプロバイダーの接続が完了したら、`status` を実行してプロジェクトを確認します:

```bash
stripe projects status
```

これには、プロジェクト名、Stripe アカウント、関連するプロバイダーアカウント、プロビジョニングされたリソース、現在の階層、稼働状況が表示されます。

名前付き環境を持つプロジェクトでは、`status` に環境メンバーシップも表示され、このチェックアウトのアクティブな環境がマークされます。

## プロジェクトを一覧表示

`stripe projects list` を使用して、Stripe アカウントのすべてのプロジェクトを表示します。

```bash
stripe projects list
```

このコマンドを実行すると、各プロジェクトの名称、ID、作成日が返されます。プロジェクト ID は `stripe projects pull` と組み合わせて使用します。

## プロジェクトを引き出す

`stripe projects pull` を使用して、既存のプロジェクトを新しいローカルディレクトリにセットアップします。空のディレクトリから実行してください。

```bash
stripe projects pull <projectID>
```

このコマンドにより `.projects/state.json` および `.projects/state.local.json` が作成され、`env --pull` を実行することで `.env` ファイルに書き込まれます。プロジェクトの既存のサービスインスタンスに接続されます。新しいインスタンスはプロビジョニングされません。

プロジェクト ID を確認するには、`stripe projects list` を実行します。

## プロジェクトをワークフローに導入する

Stripe プロジェクトは、新しいアプリケーション、既存のコードベース、および有効な設定に使用できます。

### 新しいプロジェクトを開始

新しいアプリがある場合は、プロジェクトの作成、プロバイダーアカウントの関連付け、新しいアカウントの作成、データベース、認証、分析などのリソースのプロビジョニングを行うことができます。

### 既存のコードベースにサービスを追加する

既存のアプリケーションディレクトリで Stripe プロジェクトを初期化できます。既存のディレクトリを使用してサービスを追加すると、新しい認証情報と環境変数が既存の環境 (`.env`) とプロジェクト構成にマージされます。これは、アプリにすでにホスティングがあるが、データベース、認証、分析、機能フラグ、その他の管理対象インフラなどのサービスが必要な場合に便利です。

### 既存の設定を管理する

すでに使用しているプロバイダーアカウントを Stripe アカウントに関連付けると、プロジェクトは 1 つの場所に表示されます。これにより、既存のリソースを関連付け、関連する環境変数を追加することもできます。

## サービスカタログを参照する

`catalog` を使用して、利用可能なすべてのプロバイダー、そのサービスカテゴリー、プランの段階、アドオン、価格を一覧表示します:

```bash
stripe projects catalog
stripe projects catalog <provider>
stripe projects catalog <category>
```

`search` を使って、キーワードに関連するすべての利用可能なプロバイダーサービスを探せます:

```bash
stripe projects search <keyword>
```

## サービスを管理する

### サービスを追加する

プロバイダーのサービスをプロジェクトに追加します。

```bash
stripe projects add <provider>/<service>
```

サービスを追加すると、サービスを追加する前に、既存のプロバイダーアカウントを Stripe アカウントに関連付けるか、アカウントを作成します。

サービスを追加すると、プロバイダーアカウントでリソースがプロビジョニングされます。データベース、認証インスタンス、分析プロジェクト、機能フラグ、またはその他の管理対象インフラをアプリにプロビジョニングするには、`add` コマンドを使用します。

### プロバイダーをリンクコマンドに関連付ける

プロバイダーアカウントを関連付けるか、リソースをプロビジョニングせずにアカウントを作成します。これは、リソースをプロビジョニングする前にプロバイダーとの接続を確立する場合に、エージェント主導のワークフローで役立ちます。

```bash
stripe projects link <provider>
```

### サービスを削除する

プロバイダーアカウントとローカルプロジェクトからサービスを削除します。

```bash
stripe projects remove <provider>/<service>
#or
stripe projects remove <resource_name>
```

### 認証情報のローテーション

特定のサービスの認証情報をローテーションする:

```bash
stripe projects rotate <provider>/<service>
#or
stripe projects rotate <resource_name>
```

### サービスティアのアップグレード

サービスに現在のティアよりも多くの容量、機能、または制限が必要な場合は、サービスのティアをアップグレードできます。

```bash
stripe projects upgrade <provider> | <provider>/<service> | <resource_name>
```

アップグレードする前に、ステータスまたはプロバイダーのダッシュボードで各サービスの現在のティアを確認してください。

Stripe への決済手段の登録は一度のみです。CLI で有料プランを選択すると、決済手段が [Shared Payment Token](https://docs.stripe.com/agentic-commerce/concepts/shared-payment-tokens.md) にトークン化されます。あわせて、そのアップグレード用の決済手段が決済代行業者に付与されます。決済代行業者はこのトークンを使って請求するため、元の決済手段が共有されることはありません。

> [有料サービスに対応している国](https://docs.stripe.com/projects/paid-tier-countries.md)をご確認ください。

### プロバイダーダッシュボードを開く

デフォルトのブラウザーでプロバイダーのダッシュボードを開きます:

```bash
stripe projects open <provider>
```

## 環境変数を管理する

Stripe Projects は認証情報をボールトに格納し、サービスを追加または変更したときに環境変数をローカル環境 (`.env`) に自動的に同期します。

### 変数の一覧表示

すべてのプロジェクト環境変数を表示します。値は出力に表示されません。

```bash
stripe projects env
```

環境変数も、リソースのプロビジョニング後に自動的に同期されます。

### 変数の同期

アクティブな環境の出力ファイルを更新し、認証情報の保管庫を補充します。デフォルト環境では、別の出力パスを設定していない限り、`.env` に書き込まれます。名前付き環境では、環境の作成時または更新時に設定した出力ファイルに書き込まれます。

```bash
stripe projects env --pull
```

### env --pull を実行するタイミング

`env --pull` は、サービスのプロビジョニング、認証情報のローテーション、またはリソースのアップグレードの後に自動的に実行されます。このような場合に手動で実行する必要はありません。

次の場合は、`env --pull` を手動で実行します。

- 新しいマシンでプロジェクトをセットアップするとき、またはリポジトリをクローンした後。
- チームメイトがリソースをプロビジョニングまたはローテーションし、更新された認証情報を反映する必要がある。
- `.env` が削除または破損しており、復元する必要がある。
- ローカルの認証情報が現在のプロジェクトの状態と一致していることを確認したい。
- `stripe projects env use` で別の環境に切り替え、その環境の認証情報がローカルで必要な場合。
- `stripe projects env add` または `stripe projects env remove` で環境メンバーシップを変更した場合。

```bash
stripe projects env --pull
```

### 本番環境の環境変数を設定する

`stripe projects env --pull` は、アクティブな環境のローカル出力ファイルに認証情報を書き込みます。本番ホストには環境変数を書き込みません。

本番環境で同じ認証情報を使用するには、それらをホストの環境変数設定に追加してください。Stripe Projects ではこの手順は自動化されません。

> 多くの場合、プロバイダーには `.env` ファイルを読み取れる独自の CLI ツールがあります。推奨されるインポートのワークフローについては、プロバイダーのドキュメントを確認してください。

### 複数の環境を管理

ローカル開発、ステージング、本番など、アプリのさまざまな段階で認証情報とリソースを個別に保持するには、プロジェクト環境を使用します。

各環境には以下が含まれます。

- `default`、`development`、`staging`、または `production` などの名前
- `.env`、`.env.dev`、または `.env.production` などの出力ファイル
- 認証情報がその出力ファイルに書き込まれるプロジェクトリソースのセット

Stripe Projects はローカルコマンドにアクティブな環境を使用します。リソースを追加したり認証情報を同期したりするコマンドは、アクティブな環境を対象とします。

環境を一覧表示:

```bash
stripe projects env list
```

アクティブな環境を表示:

```bash
stripe projects env show
```

新しい環境を作成してアクティブにする:

```bash
stripe projects env create development --output .env.dev
```

アクティブな環境を切り替える:

```bash
stripe projects env use default
stripe projects env use development
```

環境を切り替えた後、`stripe projects add` はアクティブな環境にリソースをプロビジョニングし、`stripe projects env --pull` はその環境の認証情報を設定された出力ファイルに書き込みます。

```bash
# Add a database to the active development environment
stripe projects env use development
stripe projects add neon/postgres --name dev-db
stripe projects env --pull

# Switch back to the default environment and pull its credentials
stripe projects env use default
stripe projects env --pull
```

アクティブな環境の名前または出力ファイルを更新:

```bash
stripe projects env update --name staging
stripe projects env update --output .env.staging
```

環境を削除:

```bash
stripe projects env delete staging
```

最後の環境または仮想的な `default` 環境は削除できません。

### 環境リソースの管理

環境メンバーシップによって、どのプロジェクトリソースの認証情報がアクティブな環境の出力ファイルに書き込まれるかが決まります。

既存のプロジェクトリソースをアクティブな環境に追加:

```bash
stripe projects env add <resource_name>
```

アクティブな環境からリソースを削除:

```bash
stripe projects env remove <resource_name>
```

これらのコマンドは環境メンバーシップのみを変更します。プロバイダーリソースをプロビジョニング、削除、またはローテーションすることはありません。プロジェクトからプロバイダーリソースを削除するには、`stripe projects remove` を使用します。

`stripe projects status` または `stripe projects services list` を実行して、リソース名を見つけます。

## 請求の管理

決済手段は Stripe アカウントに関連付けられています。

### 決済手段の表示

登録されている決済手段を表示する:

```bash
stripe projects billing show
```

### 決済手段の追加または更新

決済手段を追加するか、既存の決済手段を置き換えます。

```bash
stripe projects billing add
```

決済手段を設定すると、[利用限度額が設定](https://docs.stripe.com/projects.md#set-a-spend-limit)できるようになります。

### 利用額を表示

`stripe projects spend` を実行すると、今月と過去の月のプロバイダー別の利用額を確認できます。

```bash
stripe projects spend
```

出力には以下の利用額が表示されます。

- **当月**: 現在までの利用額、プロバイダー別
- **過去の月**: 合計利用額、プロバイダー別

### 利用限度額を設定

`stripe projects billing update` を使用して、決済手段に利用限度額を設定します。すべてのプロバイダーを包括する全体的な限度額を設定することも、より細かく管理できるようプロバイダーごとの限度額を設定することも可能です。

コマンドを対話式で実行して、限度額の種類を選択し、値を入力します。

```bash
stripe projects billing update
```

また、`--limit` フラグを直接含めることでプロンプトをスキップすることもできます。すべてのプロバイダーに適用される包括的な限度額を設定する方法は以下のとおりです。

```bash
stripe projects billing update --limit <amount>
```

特定のプロバイダーの限度額を設定する方法は以下のとおりです。

```bash
stripe projects billing update --limit <amount> --provider <provider>
```

プロバイダー別の限度額と全体的な限度額双方が設定されている場合、プロバイダー別の限度額が優先されます。個別に上限を設定したいプロバイダー別に、にコマンドを 1 回実行します。

## LLM コンテキストを生成

プロジェクトコンテキストとプロバイダーが提供するすべての LLM コンテキストファイルを組み合わせたローカルファイルを表示および書き込みます:

```bash
stripe projects llm-context
```

## プロジェクトを共有

`stripe projects share` を使用して、プロジェクトのサービススタックをエンコードした URL を生成します。この URL には追加済みのサービスが含まれますが、認証情報や設定値は含まれません。

これは、1 つ以上のサービスを含むプロジェクトディレクトリから実行します。

```bash
stripe projects share
```

URL をコピーして任意の相手と共有できます。URL は自己完結型で有効期限はありません。

### 共有スタックから新しいプロジェクトをセットアップ

空のディレクトリで `stripe projects init` を `--from` フラグを付けて実行します。

```bash
stripe projects init --from <URL>
```

これにより新しいプロジェクトが初期化され、共有スタック内の各サービスの新しいインスタンスがプロビジョニングされます。

### 既存のプロジェクトにサービスを追加

すでに初期化されたプロジェクトディレクトリから `stripe projects import` を実行します。

```bash
stripe projects import <URL>
```

これにより共有スタックのサービスがプロビジョニングされ、既存のプロジェクトに追加されます。

## 利用可能なプロバイダー

これらのプロバイダーは、導入プロトコルを Stripe と共同で設計しました。このプロトコルは、プロビジョニング、プランの選択、アップグレード、認証情報のハンドオフを標準化します。

| プロバイダー        | 主なカテゴリー                                  |
| ------------- | ---------------------------------------- |
| AgentMail     | メール                                      |
| AgentPhone    | 通信                                       |
| Algolia       | 検索                                       |
| Amplitude     | 分析、機能フラグ                                 |
| Auth0         | Auth                                     |
| Base 44       | ホスティング、データベース、AI                         |
| Blaxel        | ホスティング、サンドボックス、AI                        |
| Browserbase   | ブラウザー、AI                                 |
| Chroma        | データベース、AI                                |
| Clerk         | 認証                                       |
| ClickHouse    | データベース、アナリティクス                           |
| Cloudflare    | ホスティング、データベース、ストレージ、ドメイン、キャッシュ、キュー、ブラウザー |
| Daytona       | サンドボックス、ホスティング                           |
| E2B           | ホスティング、サンドボックス                           |
| Elevenlabs    | AI                                       |
| Exa           | 検索、AI                                    |
| Firecrawl     | 検索                                       |
| Fly.io        | ホスティング、データベース                            |
| GitLab        | CI/CD、オブザーバビリティ、ストレージ                    |
| HeyGen        | AI                                       |
| Hugging Face  | AI、ホスティング、ストレージ                          |
| Inngest       | キュー                                      |
| Kernel        | ブラウザー、AI                                 |
| Laravel Cloud | ホスティング、キャッシュ、データベース                      |
| Metronome     | Payments                                 |
| Mixpanel      | 分析                                       |
| Neon          | データベース、認証                                |
| Netlify       | ホスティング                                   |
| OpenRouter    | AI                                       |
| Parallel      | 検索、AI                                    |
| PlanetScale   | データベース                                   |
| PostalForm    | 通信                                       |
| PostHog       | 分析、機能フラグ                                 |
| Prisma        | データベース                                   |
| Privy         | 決済、認証                                    |
| Railway       | ホスティング、データベース、ストレージ、キャッシュ                |
| Render        | ホスティング、データベース                            |
| Runloop       | サンドボックス、AI                               |
| Sentry        | オブザーバビリティ                                |
| Squarespace   | ドメイン                                     |
| Supabase      | データベース、認証、ストレージ                          |
| Supermemory   | AI、データベース、検索                             |
| Turso         | データベース                                   |
| Twilio        | 通信                                       |
| Upstash       | キャッシュ、検索、データベース                          |
| Vercel        | ホスティング                                   |
| Wix           | ホスティング                                   |
| WordPress.com | ホスティング、ドメイン                              |
| WorkOS        | Auth                                     |

`stripe projects catalog` はいつでも実行でき、プロバイダーと利用可能なサービスティアの最新リストを確認できます。あるいは、[projects.dev/providers](https://projects.dev/providers) のディレクトリをご覧ください。

> #### プロバイダーをリクエスト
> 
> Stripe Projects ネットワークのプロバイダーになることに関心がある場合、または特定のプロバイダーをリクエストする場合は、[provider-request@stripe.com](mailto:provider-request@stripe.com) にお問い合わせください。

## 非対話型環境を使用する

すべてのコマンドは、CI/CD パイプライン、スクリプト、エージェントなどの非対話型環境のフラグをサポートします。

### グローバルフラグ

| フラグ                | 説明                                             |
| ------------------ | ---------------------------------------------- |
| `-v, --version`    | 現在のプラグインバージョンを表示します。                           |
| `--json`           | フォーマットされたテキストではなく構造化 JSON として出力を返します。          |
| `--no-interactive` | 対話型プロンプトと確認ダイアログを無効にします。必要な入力がない場合、コマンドは失敗します。 |
| `--auto-confirm`   | サービスを削除する場合など、確認プロンプトを自動的に受け入れます。              |
| `--quiet`          | 必須ではない出力を抑制し、最終結果またはエラーのみを返します。                |
| `--accept-tos`     | 確認を求めずに、プロバイダーの利用規約に同意します。                     |
| `--stream`         | ストリーミング出力のアニメーションを有効にします。                      |
| `--debug`          | Stripe API リクエストのデバッグログを有効にします。                |

## コマンドリファレンス

| コマンド                                    | 説明                                                                                                                               |
| --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| `add<provider> /<service>`              | プロジェクトにサービスを追加します。                                                                                                               |
| `billing add`                           | 決済手段を追加または置き換えます。                                                                                                                |
| `billing show`                          | 現在の決済手段を表示します。                                                                                                                   |
| `billing update`                        | 既存の決済手段を更新するか、利用限度額を設定します。すべてのプロバイダーに対して包括的な月間限度額を設定するには `--limit` を使用します。また、プロバイダー別の限度額を設定するには `--limit` と `--provider` を併用します。 |
| `catalog`                               | 利用可能なプロバイダー、カテゴリー、サービスを一覧表示します。                                                                                                  |
| `ダウングレード<service_reference> [service]`  | プロバイダーが対応している場合は、下位ティアまたは無料プランにダウングレードできます。                                                                                      |
| `env`                                   | 値を明かさずにプロジェクトの環境変数を一覧表示します。                                                                                                      |
| `env --pull`                            | アクティブな環境の認証情報を、その環境の構成済み出力ファイルに同期します。                                                                                            |
| `env list`                              | プロジェクト環境を一覧表示し、アクティブな環境をマークします。                                                                                                  |
| `env show`                              | アクティブな環境、その出力ファイル、およびリソースメンバーシップを表示します。                                                                                          |
| `env create <name> --output <path>`     | 環境を作成し、アクティブにします。                                                                                                                |
| `env use <name>`                        | この決済でアクティブな環境を切り替えます。                                                                                                            |
| `env update --name <new-name>`          | アクティブな環境の名前を変更します。                                                                                                               |
| `env update --output <path>`            | アクティブな環境の出力ファイルを変更します。                                                                                                           |
| `env delete <name>`                     | 環境を削除します。                                                                                                                        |
| `env add <resource_name>`               | 既存のプロジェクトリソースをアクティブな環境に追加します。                                                                                                    |
| `env remove <resource_name>`            | アクティブな環境からプロジェクトリソースを削除します。                                                                                                      |
| `import <URL>`                          | 共有スタック URL のサービスを既存のプロジェクトに追加します。                                                                                                |
| `init <name>`                           | プロジェクトを作成し、サインインまたは登録します。                                                                                                        |
| `link <provider>`                       | プロバイダーをプロジェクトに接続します。                                                                                                             |
| `list`                                  | Stripe アカウントのすべてのプロジェクトを表示します。                                                                                                   |
| `llm-context`                           | 結合された LLM コンテキストファイルを生成します。                                                                                                      |
| `開く <provider>`                         | ブラウザーでプロバイダーのダッシュボードを開きます。                                                                                                       |
| `pull <projectID>`                      | 既存のプロジェクトを新しいローカルディレクトリにセットアップします。                                                                                               |
| `削除<service_reference>`                 | プロジェクトからサービスを削除します。                                                                                                              |
| `ローテーションする<service_reference>`          | サービスの認証情報をローテーションします。                                                                                                            |
| `検索`                                    | キーワードをもとに利用可能なプロバイダーサービスを一覧表示します。                                                                                                |
| `サービスのリスト`                              | プロジェクトのすべてのサービスを表示します。                                                                                                           |
| `share`                                 | プロジェクトのサービススタックをエンコードした共有可能な URL を生成します。                                                                                         |
| `spend`                                 | 当月と過去の月のプロバイダー別の利用額を表示します。                                                                                                       |
| `status`                                | プロジェクト名、サービス、ティア、状況を表示します。                                                                                                       |
| `アカウントの切り替え`                            | 別の Stripe アカウントに切り替えます。                                                                                                          |
| `リンクを解除<provider>`                      | プロジェクトからプロバイダーの接続を解除します。                                                                                                         |
| `[service] を更新<service_reference>`      | 同じプロバイダー内のリソースを更新します。                                                                                                            |
| `[service] をアップグレード<service_reference>` | サービスのティアを変更します。                                                                                                                  |

## エージェント連携ガイド

### Stripe Projects の使用例

ユーザーから次の依頼があった場合は、Stripe Projects を使用します:

- データベース、キャッシュ、オーソリ、ホスティング、分析、オブザーバビリティ、またはサードパーティのインフラストラクチャをプロビジョニングする。
- サードパーティサービスの API キー、認証情報、シークレット、またはトークンを取得する。
- Neon、Supabase、PlanetScale、Upstash、Clerk、Auth0、WorkOS、Vercel、Netlify、Railway、Render、Fly.io、Cloudflare、Sentry、PostHog、Mixpanel、Amplitude、OpenRouter、Hugging Face、Elevenlabs、Twilio、Resend、Algolia、Chroma、Turso、Inngest、Browserbase、Daytona、Runloop、Privy、Squarespace、GitLab、AgentMail などのサービスに登録または接続する。
- LLM プロバイダー、モデルプロバイダー、ベクトルデータベース、メッセージキュー、オブジェクトストレージ、メール送信、検索、または機能フラグを設定する。
- 利用可能なサービスを参照する、プロジェクトのステータスを確認する、プロビジョニングされたリソースを一覧表示する、または環境変数を参照する。
- projects.dev、Stripe Projects、Stripe Projects カタログ、またはクラウドサービスの追加、プロビジョニング、接続への言及

上記のサービスに手動で登録するようユーザーに指示しないでください。まず Projects catalog を確認し、プログラムでプロビジョニングしてください。

### ブートストラップワークフロー

ステップ 1 — Stripe CLI がインストールされていることを確認する:

```bash
which stripe && stripe --version
```

見つからない場合、または 1.40.0 未満の場合:

- macOS: brew install stripe/stripe-cli/stripe (または brew upgrade stripe/stripe-cli/stripe)
- その他のプラットフォーム: ユーザーをhttps://docs.stripe.com/stripe-cli/installに誘導する

Projects プラグインをインストールする:

```bash
stripe plugin install projects
```

ステップ 2 — サービスが存在することを確認するために、カタログを検索します。

```bash
stripe projects search <query> --json
```

リクエストが曖昧な場合は、カタログ全体を参照します。

```bash
stripe projects catalog --json
```

ステップ 3 — まだであれば初期化します。

```bash
stripe projects status --json
stripe projects init --yes
```

CLI が認証のためにブラウザを開いた場合は停止し、サインインを完了するようユーザーにはっきり伝えてください。確認が取れるまで、以降のコマンドは実行しないでください。

ステップ 4 — .skills/stripe-projects-cli/ にあるローカルにインストールされた stripe-projects-cli スキルに引き継ぎます (init 時にインストールされます)。add、link、env、rotate、upgrade、remove など、以降のすべてのコマンドではそのスキルを使用します。

### ルール

- 環境変数の値は決して表示せず、名前のみを表示してください。
- カタログ出力にないプロバイダー名やコマンドをでっち上げないでください。
- .projects/ や .env は手動で編集しないでください。CLI を正とします。
- 構造化出力のため、init を除くすべてのコマンドで --json を使用します。

### エラー回復

- PROVIDER_NOT_LINKED: stripe projects link <provider> を実行します。
- UNKNOWN_ERROR: 完全なエラー内容を表示し、–debug を提案します。
- サービスがカタログにない: ユーザーに伝え、カタログを参照するよう提案します。
- CLI が見つからない: 上記のプラットフォーム別の手順に従ってインストールします。