# Stripe Projects CLI Ajoutez des services tiers à votre application, synchronisez les identifiants avec votre projet et gérez les mises à jour. Pour plus de détails, consultez la [documentation de l’interface de ligne de commande (CLI) Stripe](https://docs.stripe.com/cli.md). Stripe Projects configure et gère des services tiers (tels que l’hébergement, les bases de données, l’autorisation, l’IA et l’observabilité) depuis le terminal. Exécutez une seule commande pour créer vos comptes, synchroniser les identifiants avec votre fichier `.env` et gérer la facturation via Stripe. - **Configurez** des services auprès de [plus de 30 fournisseurs](https://docs.stripe.com/projects.md#available-providers). Aucun dashboard séparé. - **Synchronisez** automatiquement les identifiants avec `.env`. Aucun copier-coller de clés d’API. - **Gérez** les offres, la facturation, les environnements et les clés depuis la CLI ou votre agent de codage. ## Commencez avec un agent de codage Installez la compétence Stripe Projects dans Claude Code, Cursor, Codex ou tout agent de codage compatible avec MCP : ```bash npx skills add https://docs.stripe.com --skill stripe-projects -g -y ``` Décrivez ensuite la suite d’outils souhaitée à votre agent : ``` "Use Stripe Projects to set up a Next.js app with Supabase, Vercel, and PostHog." ``` L’agent installe le plugin CLI, exécute `stripe projects init`, ajoute vos services et synchronise automatiquement les identifiants. ## Démarrage rapide Installez le plugin, créez un projet, ajoutez des services et récupérez les identifiants dans votre environnement local : ```bash stripe plugin install projects stripe projects init stripe projects add supabase/project stripe projects add vercel/project stripe projects env --pull ``` ## Mode de fonctionnement Un projet Stripe représente une seule application ou base de code et regroupe les services et ressources d’un compte fournisseur. - **Compte fournisseur** : le compte auprès de votre fournisseur, tel que Vercel, Supabase, Clerk ou PostHog. - **Service** : les produits proposés par le fournisseur, comme une base de données, un service d’autorisation ou d’analyse. - **Ressource** : une instance du service pour votre compte, ainsi que les identifiants et les variables d’environnement associés (par exemple, `test-db-1`, `auth` ou `test-analytics-1`). Vous pouvez utiliser un projet pour : - Associer un compte fournisseur existant ou en créer un nouveau - Mettre à disposition des ressources, telles que des bases de données, des instances d’autorisation et des projets d’analyse - Stocker les identifiants dans le coffre-fort et les synchroniser avec votre environnement (`.env`) en tant que variables d’environnement - Gérez des environnements nommés, tels que `development`, `staging` et `production`, chacun avec son propre fichier de sortie et son ensemble de ressources. - Gérer les mises à niveau et renouveler les identifiants Après avoir associé un compte fournisseur à votre compte Stripe, celui-ci reste autorisé jusqu’à ce que vous supprimiez explicitement l’association. Vous pouvez réutiliser un compte fournisseur pour de nouveaux projets avec le même compte Stripe. Si vous souhaitez utiliser un compte Stripe différent, vous devez associer à nouveau le compte fournisseur. Vous pouvez initialiser un projet dans un nouveau répertoire ou une base de code existante. Si vous utilisez une base de code existante et ajoutez des services, de nouveaux identifiants et de nouvelles variables d’environnement fusionnent avec votre environnement existant (`.env`) et la configuration du projet. ## Fonctionnement des identifiants Stripe Projects récupère les identifiants de chaque fournisseur en votre nom, les chiffre dans `.projects/vault/vault.json` et les stocke dans le Stripe [Secret Store](https://docs.stripe.com/stripe-apps/store-secrets.md) : - **Fichiers locaux** : `.projects/vault/vault.json` stocke une copie chiffrée de vos identifiants. Votre fichier `.env` est la sortie par défaut pour le développement local. Pour les environnements nommés, la CLI écrit dans le fichier de sortie configuré, tel que `.env.dev` ou `.env.production`. La CLI crée des fichiers de sortie avec les autorisations `600`. Vous seul pouvez donc les lire sur votre machine. Ne commitez pas les fichiers d’identifiants dans le contrôle de version, car `stripe projects init` les ajoute automatiquement à `.gitignore`. - **À la suppression** : l’exécution du ` stripe projects remove` retire la ressource et la supprime de l’état de votre projet. L’interface de ligne de commande ne supprime aucun identifiant précédemment écrit dans `.env` ou `.projects/vault/`. Supprimez-les manuellement, ou exécutez `stripe projects env --pull` pour les remplacer avec l’ensemble d’identifiants actuel. Pour utiliser vos identifiants dans un environnement d’hébergement de production, consultez la page [Configurer des variables d’environnement de production](https://docs.stripe.com/projects.md#production-env). ## Créer un projet Exécutez `init` dans le répertoire que vous souhaitez utiliser pour votre projet : ```bash stripe projects init [name] ``` Cela initialise un projet Stripe pour ce répertoire. Si vous omettez le nom, Stripe Projects utilise le nom du dossier. Stripe Projects écrit l’état du projet sous `.projects/`, qui suit les comptes de fournisseur associés, les ressources provisionnées et la configuration du projet local. Vous pouvez voir les outils utilisés par votre projet dans `.projects/state.json`. Le fichier `.projects/state.local.json` dans votre référentiel privé contient les ID de ressources dont votre équipe a besoin pour partager le même état de projet. ### Référence du dossier | Fichier ou dossier | Objectif | S’engager dans le contrôle des versions ? | | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- | | `state.json` | État de projet partagé pour les services, les ressources, les définitions d’environnement, les chemins de fichiers de sortie et la configuration utilisés par votre équipe. | Oui | | `state.local.json` | Vos dérogations locales et paramètres spécifiques à la machine. Stocke les associations entre les ressources de projet et les comptes de vos fournisseurs personnels, les ID de ressources back-end et l’environnement actif sélectionné sur cette machine. | Oui1 | | `.projects/vault/` | Cache d’identification chiffré écrit par la CLI après provisionnement ou `env --pull`. | Non, ajouté au fichier `.gitignore` automatiquement2 | | `.projects/cache/` | Cache des métadonnées de la CLI utilisé pour les performances. | Non, ajouté automatiquement à `.gitignore` | | `.env`, `.env.*` | Identifiants en clair pour le développement local, écrits par `env --pull` pour l’environnement actif. | Non, ajouté automatiquement à `.gitignore` | 1 Malgré la convention de nommage `.local`, vous validez toujours `state.local.json`. Il stocke les associations entre vos ressources de projet et vos comptes de fournisseur personnel. Vos coéquipiers ont besoin de ce fichier pour correctement associer leurs propres comptes avec `stripe projects link`. Si vous l’excluez du contrôle de version, vos coéquipiers reçoivent une erreur lorsqu’ils tentent l’association. L’environnement actif est local au paiement de chaque membre de l’équipe. Par conséquent, changer d’environnement ne modifie pas l’environnement actif pour les autres membres. 2 Il s’agit d’un cache d’identification local, et non d’un système de distribution de secrets partagés. Chaque coéquipier exécute `stripe projects env --pull` sur sa propre machine pour récupérer ses propres identifiants à partir du Stripe Secret Store. ## Utiliser un agent de codage Après l’initialisation d’un projet, Stripe Projects écrit les compétences des agents de codage dans le répertoire local du projet. Ces compétences fournissent un contexte et des actions permettant à votre agent de travailler avec votre projet via le flux de travail Stripe Projects. Vous pouvez demander à votre agent d’accomplir des tâches, telles que : - « Associer mon compte Neon existant et fournir une base de données » - « Ajouter l’authentification Turso et PostHog avec l’offre gratuite. » - « Configurer les services dont ce dépôt a besoin et expliquer ce qui a changé. » Votre agent utilise les mêmes commandes de l’interface de ligne de commande Stripe Projects. Vous pouvez provisionner, mettre à niveau, configurer et synchroniser les identifiants en utilisant le même chemin déterministe et vérifiable directement en tant que CLI. Pour éviter les fenêtres contextuelles du navigateur lors du provisionnement et de l’échange d’identifiants : 1. Connexion à votre compte Stripe. 2. Associez votre compte fournisseur existant (ou créez-en un nouveau) à `stripe projects link`. 3. Ajoutez un moyen de paiement avec `stripe projects billing add`. 4. Démarrez la session d’agent. ## Vérifier l’état du projet Après avoir ajouté des services ou connecté des fournisseurs, exécutez `status` pour examiner votre projet : ```bash stripe projects status ``` Cela affiche le nom de votre projet, votre compte Stripe, les comptes fournisseurs associés, les ressources provisionnées, les niveaux actuels et l’état de santé. Pour les projets avec des environnements nommés, `status` affiche également l’appartenance à l’environnement et marque l’environnement actif pour ce paiement. ## Lister les projets Utilisez `stripe projects list` pour afficher tous les projets de votre compte Stripe. ```bash stripe projects list ``` La commande renvoie le nom, l’identifiant et la date de création de chaque projet. Utilisez l’identifiant du projet avec `stripe projects pull`. ## Récupérer un projet Utilisez `stripe projects pull` pour configurer un projet existant dans un nouveau répertoire local. Exécutez la commande depuis un répertoire vide : ```bash stripe projects pull ``` La commande crée `.projects/state.json` et `.projects/state.local.json`, puis génère votre fichier `.env` en exécutant `env --pull`. Elle ne provisionne pas de nouvelles instances, mais vous connecte aux instances de service existantes du projet. Pour trouver un identifiant de projet, exécutez `stripe projects list`. ## Intégrez des projets à votre flux de travail Vous pouvez utiliser Stripe Projects pour les nouvelles applications, les bases de code existantes et les configurations actives. ### Démarrez un nouveau projet Si vous avez une nouvelle application, vous pouvez créer un projet, associer des comptes fournisseurs ou en créer de nouveaux, et provisionner des ressources telles qu’une base de données, l’autorisation et l’analytique. ### Ajoutez des services à une base de code existante Vous pouvez initialiser Stripe Projects dans un répertoire d’application existant. Si vous utilisez un répertoire existant et ajoutez des services, les nouveaux identifiants et variables d’environnement sont fusionnés avec votre environnement existant (`.env`) et la configuration du projet. Cela est utile lorsqu’une application dispose déjà d’un hébergement mais nécessite des services, tels qu’une base de données, l’authentification, l’analytique, les indicateurs de fonctionnalités ou d’autres infrastructures gérées. ### Gérez une configuration existante Lorsque vous associez les comptes de fournisseurs que vous utilisez déjà à votre compte Stripe, le projet est représenté à un emplacement unique. Cela vous permet également d’associer des ressources existantes et d’ajouter des variables d’environnement pertinentes. ## Parcourir le catalogue de services Utilisez `catalog` pour lister tous les fournisseurs disponibles, leurs catégories de services, les niveaux de plan, les modules complémentaires et les tarifs : ```bash stripe projects catalog stripe projects catalog stripe projects catalog ``` Utilisez `search` pour explorer tous les services de fournisseurs disponibles liés à un mot-clé : ```bash stripe projects search ``` ## Gérer un service ### Ajouter un service Ajoutez un service de prestataire à votre projet : ```bash stripe projects add / ``` Lorsque vous ajoutez un service, cette action associe un compte fournisseur existant à votre compte Stripe ou en crée un, avant d’ajouter le service. L’ajout d’un service permet de provisionner une ressource dans votre compte fournisseur. Utilisez la commande `add` pour provisionner une base de données, une instance d’autorisation, un projet d’analyse, des indicateurs de fonctionnalités ou toute autre infrastructure gérée pour votre application. ### Associez un fournisseur avec la commande link Associez un compte fournisseur ou créez un compte sans provisionner de ressource. Cela est utile dans les workflows pilotés par un agent, lorsque vous souhaitez établir une connexion avec le fournisseur avant de provisionner des ressources. ```bash stripe projects link ``` ### Supprimer un service Supprimez un service de votre compte opérateur et de votre projet local : ```bash stripe projects remove / #or stripe projects remove ``` ### Faire pivoter un identifiant Faites pivoter les identifiants pour un service spécifique : ```bash stripe projects rotate / #or stripe projects rotate ``` ### Mettre à niveau un niveau de service Vous pouvez mettre à niveau le niveau de service lorsqu’un service nécessite plus de capacité, de fonctionnalités ou de limites que ce que le niveau actuel offre. ```bash stripe projects upgrade | / | ``` Avant de procéder à la mise à niveau, vérifiez le niveau actuel de chaque service dans l’état ou sur le Dashboard de votre fournisseur. Vous ne devez ajouter votre moyen de paiement à Stripe qu’une seule fois. Lorsque vous sélectionnez un forfait payant dans l’interface en ligne de commande (CLI), Stripe tokenise vos informations de paiement en un [token de paiement partagé](https://docs.stripe.com/agentic-commerce/concepts/shared-payment-tokens.md) et accorde au fournisseur un identifiant de paiement pour cette mise à niveau. Le fournisseur effectue la facturation à l’aide de ce token. Vos informations de paiement sous-jacentes ne sont pas partagées. > Consultez la liste des [pays de niveau payant](https://docs.stripe.com/projects/paid-tier-countries.md). ### Ouvrir le Dashboard du fournisseur Ouvrez le Dashboard d’un fournisseur dans votre navigateur par défaut : ```bash stripe projects open ``` ## Gérer les variables d’environnement Stripe Projects stocke les identifiants dans le coffre-fort et synchronise automatiquement les variables d’environnement avec votre environnement local (`.env`) lorsque vous ajoutez ou modifiez des services. ### Lister les variables Affichez toutes les variables d’environnement du projet. Les valeurs ne sont pas révélées dans la sortie : ```bash stripe projects env ``` Les variables d’environnement se synchronisent également automatiquement après la mise en service des ressources. ### Synchroniser les variables Mettez à jour le fichier de sortie de l’environnement actif et réapprovisionnez votre coffre-fort d’identifiants. Pour l’environnement par défaut, cela écrit dans `.env`, sauf si vous avez configuré un chemin de sortie différent. Pour les environnements nommés, cela écrit dans le fichier de sortie configuré lors de la création ou de la mise à jour de l’environnement. ```bash stripe projects env --pull ``` ### Quand exécuter env --pull `env --pull` s’exécute automatiquement après la fourniture d’un service, la rotation des identifiants ou la mise à niveau d’une ressource. Dans ce cas, vous n’avez pas besoin de l’exécuter manuellement. Exécutez `env --pull` manuellement lorsque : - Vous configurez le projet sur une nouvelle machine ou après avoir dupliqué le référentiel. - Un coéquipier a mis en service ou fait tourner une ressource et vous devez récupérer les identifiants mis à jour. - Votre `.env` a été supprimé ou corrompu et vous devez le restaurer. - Vous souhaitez vérifier que vos identifiants locaux correspondent à l’état actuel du projet. - Vous êtes passé à un autre environnement avec `stripe projects env use` et avez besoin des identifiants de cet environnement localement. - Vous avez modifié l’appartenance à l’environnement avec `stripe projects env add` ou `stripe projects env remove`. ```bash stripe projects env --pull ``` ### Configurer des variables d’environnement de production `stripe projects env --pull` écrit les identifiants dans le fichier de sortie local de l’environnement actif. Il n’écrit pas les variables d’environnement sur votre hôte de production. Pour utiliser les mêmes identifiants en production, ajoutez-les aux paramètres des variables d’environnement de votre hôte. Stripe Projects n’automatise pas cette étape. > Souvent, les fournisseurs disposent de leurs propres outils de CLI qui peuvent lire à partir d’un fichier `.env`. Consultez la documentation de votre fournisseur pour connaître le flux d’importation recommandé. ### Gérer plusieurs environnements Utilisez les environnements de projet pour conserver des identifiants et des ressources distincts pour les différentes étapes de votre application, telles que le développement local, la simulation et la mise en production. Chaque environnement possède : - Un nom, tel que `default`, `development`, `staging` ou `production` - Un fichier de sortie, tel que `.env`, `.env.dev` ou `.env.production` - Un ensemble de ressources de projet dont les identifiants sont écrits dans ce fichier de sortie Stripe Projects utilise un environnement actif pour les commandes locales. Les commandes qui ajoutent des ressources ou synchronisent des identifiants ciblent l’environnement actif. Listez vos environnements : ```bash stripe projects env list ``` Affichez l’environnement actif : ```bash stripe projects env show ``` Créez un nouvel environnement et rendez-le actif : ```bash stripe projects env create development --output .env.dev ``` Basculez l’environnement actif : ```bash stripe projects env use default stripe projects env use development ``` Après avoir changé d’environnement, `stripe projects add` configure les ressources dans l’environnement actif, et `stripe projects env --pull` écrit les identifiants de cet environnement dans son fichier de sortie configuré. ```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 ``` Mettez à jour le nom ou le fichier de sortie de l’environnement actif : ```bash stripe projects env update --name staging stripe projects env update --output .env.staging ``` Supprimez un environnement : ```bash stripe projects env delete staging ``` Vous ne pouvez pas supprimer le dernier environnement ni l’environnement virtuel `default`. ### Gérez les ressources de l’environnement L’appartenance à l’environnement contrôle quelles ressources du projet fournissent des identifiants au fichier de sortie de l’environnement actif. Ajoutez une ressource de projet existante à l’environnement actif : ```bash stripe projects env add ``` Supprimez une ressource de l’environnement actif : ```bash stripe projects env remove ``` Ces commandes modifient uniquement l’appartenance à l’environnement. Elles ne configurent, ne suppriment ni ne font de rotation des ressources du fournisseur. Pour supprimer une ressource de fournisseur du projet, utilisez `stripe projects remove`. Exécutez `stripe projects status` ou `stripe projects services list` pour trouver les noms des ressources. ## Gérer la facturation Moyens de paiement associés à votre compte Stripe ### Afficher le moyen de paiement Affichez votre moyen de paiement enregistré : ```bash stripe projects billing show ``` ### Ajouter ou mettre à jour un moyen de paiement Ajoutez un moyen de paiement ou remplacez un moyen existant : ```bash stripe projects billing add ``` Une fois que vous avez configuré un moyen de paiement, vous pouvez [définir une limite de dépenses](https://docs.stripe.com/projects.md#set-a-spend-limit). ### Consulter vos dépenses Exécutez `stripe projects spend` pour afficher vos dépenses pour les mois en cours et précédents, réparties par fournisseur. ```bash stripe projects spend ``` La sortie affiche vos dépenses pour : - **Mois en cours** : dépenses à ce jour, par fournisseur - **Mois précédents** : total des dépenses, par fournisseur ### Définir une limite de dépenses Utilisez `stripe projects billing update` pour définir des limites de dépenses sur votre moyen de paiement. Vous pouvez définir une limite globale qui s’applique à tous les fournisseurs, ou une limite par fournisseur pour un contrôle plus spécifique. Exécutez la commande de manière interactive pour choisir le type de limite et saisir vos valeurs : ```bash stripe projects billing update ``` Vous pouvez également inclure l’indicateur `--limit` directement pour ignorer les invites. Pour définir une limite globale à tous les fournisseurs : ```bash stripe projects billing update --limit ``` Pour définir une limite pour un fournisseur spécifique : ```bash stripe projects billing update --limit --provider ``` Les limites par fournisseur ont la priorité sur une limite globale lorsque les deux sont définies. Exécutez la commande une fois pour chaque fournisseur que vous souhaitez plafonner individuellement. ## Générer un contexte LLM Affichez et écrivez un fichier local qui combine le contexte de votre projet avec tous les fichiers de contexte LLM fournis par les fournisseurs : ```bash stripe projects llm-context ``` ## Partager un projet Utilisez `stripe projects share` pour générer une URL qui encode la suite de services de votre projet. L’URL capture les services que vous avez ajoutés, mais pas vos identifiants ni les valeurs de votre configuration. Exécutez cette commande depuis un répertoire de projet contenant au moins un service : ```bash stripe projects share ``` Copiez l’URL et partagez-la avec n’importe qui. L’URL est autonome et n’expire pas. ### Configurer un nouveau projet à partir d’une suite d’outils partagée Exécutez `stripe projects init` avec l’indicateur `--from` dans un répertoire vide : ```bash stripe projects init --from ``` Cela initialise un nouveau projet et provisionne de nouvelles instances pour chaque service de la suite d’outils partagée. ### Ajouter des services à un projet existant Exécutez `stripe projects import` depuis un répertoire de projet déjà initialisé : ```bash stripe projects import ``` Cela provisionne les services de la suite d’outils partagée et les ajoute à votre projet existant. ## Fournisseurs disponibles Ces fournisseurs ont co-conçu le protocole d’intégration avec Stripe. Ce protocole normalise le provisionnement, la sélection des plans, les mises à niveau et la transmission des identifiants. | Fournisseur | Catégories principales | | ------------- | ------------------------------------------------------------------------------------ | | AgentMail | Email | | AgentPhone | Communications | | Algolia | Recherche | | Amplitude | Analytique, indicateurs de fonctionnalités | | Auth0 | Auth | | Base 44 | Hébergement, base de données, IA | | Blaxel | Hébergement, environnement de test, IA | | Browserbase | Navigateur, IA | | Chroma | Base de données, IA | | Clerk | Identification | | ClickHouse | Base de données, analyse | | Cloudflare | Hébergement, base de données, stockage, domaines, cache, files d’attente, navigateur | | Daytona | Environnements de test, hébergement | | E2B | Hébergement, environnement de test | | Elevenlabs | IA | | Exa | Recherche, IA | | Firecrawl | Recherche | | Fly.io | Hébergement, base de données | | GitLab | CI/CD, observabilité, stockage | | HeyGen | IA | | Hugging Face | IA, hébergement, stockage | | Inngest | File d’attente | | Kernel | Navigateur, IA | | Laravel Cloud | Hébergement, cache, base de données | | Metronome | Payments | | Mixpanel | Analyses | | Neon | Base de données, authentification | | Netlify | Hébergement | | OpenRouter | IA | | Parallel | Recherche, IA | | PlanetScale | Base de données | | PostalForm | Communications | | PostHog | Analytique, indicateurs de fonctionnalités | | Prisma | Base de données | | Privy | Paiements, authentification | | Railway | Hébergement, base de données, stockage, cache | | Render | Hébergement, base de données | | Runloop | Environnements de tests, IA | | Sentry | Observabilité | | Squarespace | Domaines | | Supabase | Base de données, authentification, stockage | | Supermemory | IA, base de données, recherche | | Turso | Base de données | | Twilio | Communications | | Upstash | Cache, recherche, base de données | | Vercel | Hébergement | | Wix | Hébergement | | WordPress.com | Hébergement, domaines | | WorkOS | Auth | Exécutez `stripe projects catalog` à tout moment pour consulter la liste la plus récente des fournisseurs et des niveaux de service disponibles. Vous pouvez également consulter le répertoire sur [projects.dev/providers](https://projects.dev/providers). > #### Demander un fournisseur > > Contactez [provider-request@stripe.com](mailto:provider-request@stripe.com) si vous souhaitez devenir fournisseur sur le réseau Stripe Projects ou demander l’ajout d’un fournisseur spécifique. ## Utiliser des environnements non interactifs Chaque commande prend en charge des indicateurs pour les environnements non interactifs, tels que les pipelines CI/CD, les scripts et les agents. ### Indicateurs globaux | Indicateur | Description | | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------- | | `-v, --version` | Afficher la version actuelle du plugin. | | `--json` | Renvoie la sortie sous forme de JSON structuré au lieu d’un texte formaté. | | `--no-interactive` | Désactive les invites interactives et les boîtes de dialogue de confirmation. Les commandes échouent lorsqu’une entrée requise est manquante. | | `--auto-confirm` | Accepte automatiquement les invites de confirmation, par exemple lorsque vous supprimez un service. | | `--quiet` | Supprime les sorties non essentielles et renvoie uniquement les résultats finaux ou les erreurs. | | `--accept-tos` | Accepter les conditions d’utilisation du fournisseur sans y être invité. | | `--stream` | Activer les animations de sortie en streaming. | | `--debug` | Activer la journalisation du débogage pour les requêtes API Stripe. | ## Référence des commandes | Commande | Description | | ----------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `add /` | Ajouter un service à votre projet. | | `billing add` | Ajouter ou remplacer un moyen de paiement. | | `billing show` | Afficher le moyen de paiement actuel. | | `billing update` | Mettez à jour un moyen de paiement existant ou définissez une limite de dépenses. Utilisez `--limit` pour définir une limite mensuelle globale pour tous les fournisseurs, ou `--limit` avec `--provider` pour définir une limite par fournisseur. | | `catalog` | Dressez la liste des fournisseurs, catégories et services disponibles. | | `downgrade [service]` | Passer à un niveau inférieur ou à un plan gratuit si pris en charge par le fournisseur. | | `env` | Répertorier les variables d’environnement du projet sans révéler les valeurs. | | `env --pull` | Synchroniser les identifiants pour l’environnement actif avec le fichier de sortie configuré de cet environnement. | | `env list` | Répertorier les environnements de projet et marquer l’environnement actif. | | `env show` | Afficher l’environnement actif, son fichier de sortie et l’appartenance des ressources. | | `env create --output ` | Créer un environnement et le rendre actif. | | `env use ` | Changer l’environnement actif pour ce paiement. | | `env update --name ` | Renommer l’environnement actif. | | `env update --output ` | Modifier le fichier de sortie de l’environnement actif. | | `env delete ` | Supprimer un environnement. | | `env add ` | Ajouter une ressource de projet existante à l’environnement actif. | | `env remove ` | Retirer une ressource de projet de l’environnement actif. | | `import ` | Ajoutez des services depuis une URL de suite d’outils partagée à un projet existant. | | `init ` | Créer un projet et se connecter ou s’inscrire. | | `link ` | Connecter un fournisseur à votre projet. | | `list` | Affichez tous les projets de votre compte Stripe. | | `llm-context` | Générer un fichier de contexte LLM combiné. | | `open ` | Ouvrir le Dashboard d’un fournisseur dans le navigateur. | | `pull ` | Configurez un projet existant dans un nouveau répertoire local. | | `remove ` | Supprimer un service de votre projet. | | `rotate ` | Faire pivoter les identifiants d’un service. | | `search` | Lister les services de fournisseurs disponibles selon un mot-clé. | | `services list` | Affiche tous les services d’un projet. | | `share` | Générez une URL partageable qui encode la suite de services de votre projet. | | `spend` | Affichez vos dépenses pour les mois en cours et précédents, réparties par fournisseur. | | `status` | Afficher le nom du projet, les services, les niveaux et l’état de santé. | | `switch-account` | Changer de compte Stripe. | | `unlink ` | Déconnecter un prestataire de votre projet. | | `update [service]` | Mettre à jour une ressource au sein du même fournisseur. | | `upgrade [service]` | Modifier le niveau d’un service. | ## Guide d’intégration des agents ### Quand utiliser Stripe Projects Utilisez Stripe Projects lorsque l’utilisateur demande à : - Provisionner une base de données, un cache, un service d’autorisation, un hébergement, des analyses, une observabilité ou toute infrastructure tierce - Obtenir une clé d’API, des identifiants, un secret ou un token pour un service tiers - S’inscrire ou se connecter à un service tel que 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 - Configurer un fournisseur de LLM, un fournisseur de modèles, une base de données vectorielle, une file d’attente de messages, un stockage d’objets, un envoi d’e-mails, une recherche ou des indicateurs de fonctionnalités - Parcourir les services disponibles, vérifier l’état du projet, lister les ressources provisionnées ou afficher les variables d’environnement - Toute mention de projects.dev, de Stripe Projects, du catalogue Stripe Projects ou de l’ajout, du provisionnement ou de la connexion d’un service cloud Ne demandez PAS à l’utilisateur de s’inscrire manuellement à l’un des services ci-dessus. Consultez d’abord le catalogue Projects et provisionnez par voie programmatique. ### Flux de démarrage Étape 1 : vérifiez que la CLI Stripe est installée : ```bash which stripe && stripe --version ``` Si elle est manquante ou inférieure à la version 1.40.0 : - macOS : brew install stripe/stripe-cli/stripe (ou brew upgrade stripe/stripe-cli/stripe) - Autres plateformes : redirigez l’utilisateur vers https://docs.stripe.com/stripe-cli/install Installez le plugin Projects : ```bash stripe plugin install projects ``` Étape 2 : recherchez dans le catalogue pour confirmer que le service existe : ```bash stripe projects search --json ``` Si la requête est vague, parcourez l’ensemble du catalogue : ```bash stripe projects catalog --json ``` Étape 3 : initialisez (si ce n’est pas déjà fait) : ```bash stripe projects status --json stripe projects init --yes ``` Si la CLI ouvre un navigateur pour l’authentification, arrêtez-vous et demandez clairement à l’utilisateur de se connecter. N’exécutez pas d’autres commandes tant qu’il n’a pas confirmé. Étape 4 : passez la main à la compétence stripe-projects-cli installée localement dans .skills/stripe-projects-cli/ (installée lors de l’initialisation). Utilisez cette compétence pour toutes les commandes ultérieures : add, link, env, rotate, upgrade, remove. ### Règles - N’affichez jamais les valeurs des variables d’environnement, uniquement leurs noms. - N’inventez jamais de noms de fournisseurs ou de commandes qui ne figurent pas dans la sortie du catalogue. - Ne modifiez pas manuellement .projects/ ou .env, la CLI fait autorité. - Utilisez --json sur toutes les commandes à l’exception de init pour obtenir une sortie structurée. ### Récupération d’erreur - PROVIDER_NOT_LINKED : exécutez stripe projects link - UNKNOWN_ERROR : affichez l’erreur complète, suggérez --debug - Service absent du catalogue : informez l’utilisateur, suggérez de parcourir le catalogue - CLI introuvable : installez-la selon les instructions de la plateforme ci-dessus