Stripe Projects CLIVersion bêta publique

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.

• Provisionnez des services auprès de plus de 60 fournisseurs. Aucun Dashboard distinct n’est nécessaire.
• 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 :

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 :

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 :

• 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 <service> 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.

Créer un projet

Exécutez init dans le répertoire que vous souhaitez utiliser pour votre projet :

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

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.

Créer à partir d’un modèle

Utilisez stripe projects build pour créer une application de démarrage complète à partir du registre de modèles. La CLI copie les fichiers de l’application, installe les dépendances et configure tous les services requis en une seule étape.

Exécutez la commande de manière interactive. La CLI vous guide dans le choix d’une catégorie d’application, d’un framework et d’un niveau de trafic, puis configure la suite d’outils recommandée :

stripe projects build my-app

Si vous savez déjà quel modèle vous souhaitez, ignorez le processus guidé avec --template :

stripe projects build my-app --template stripe/nextjs-saas/amber-fox

Indiquez uniquement l’ID du modèle sans variante pour utiliser la variante par défaut :

stripe projects build my-app --template stripe/nextjs-saas

Pour voir une liste complète de tous les modèles disponibles, consultez le registre de modèles.

Pour créer votre propre modèle, consultez la section Créer un modèle de build.

Vérifier l’état du projet

Après avoir ajouté des services ou connecté des fournisseurs, exécutez status pour examiner votre projet :

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.

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 :

stripe projects pull <projectID>

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 :

stripe projects catalog
stripe projects catalog <provider>
stripe projects catalog <category>

Utilisez search pour explorer tous les services de fournisseurs disponibles liés à un mot-clé :

stripe projects search <keyword>

Gérer un service

Ajouter un service

Ajoutez un service de prestataire à votre projet :

stripe projects add <provider>/<service>

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.

stripe projects link <provider>

Supprimer un service

Supprimez un service de votre compte opérateur et de votre projet local :

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

Faire pivoter un identifiant

Faites pivoter les identifiants pour un service spécifique :

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

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.

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

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é 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.

Ouvrir le Dashboard du fournisseur

Ouvrez le Dashboard d’un fournisseur dans votre navigateur par défaut :

stripe projects open <provider>

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 :

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.

stripe projects env --pull

Gérer les variables de projet

Utilisez les variables de projet pour stocker des variables d’environnement qui ne proviennent pas d’une ressource de fournisseur provisionnée, telles que les URL d’application, les indicateurs de fonctionnalité ou les clés d’API que vous gérez vous-même.

Définissez une variable de projet et liez-la à l’environnement actif :

stripe projects variables set <name> --env-key <ENV_KEY> --value <value>

Si vous omettez --value en mode interactif, la CLI demande la valeur de manière sécurisée.

Le nom de la variable identifie la valeur sauvegardée dans Stripe Projects. La valeur --env-key est la clé écrite dans le fichier de sortie de l’environnement actif. variables set synchronise cette sortie immédiatement.

Par exemple, vous pouvez utiliser des valeurs sauvegardées différentes pour le développement et la production tout en écrivant la même clé d’environnement dans chaque fichier de sortie :

stripe projects env create development --output .env.dev
stripe projects variables set api-url-dev --env-key API_URL --value https://dev.example.com

stripe projects env create production --output .env.production
stripe projects variables set api-url-prod --env-key API_URL --value https://api.example.com

Listez les variables de projet et leurs associations avec un environnement local :

stripe projects variables list

Supprimez une variable de projet et ses associations locales :

stripe projects variables delete <name>

Pour associer une variable de projet existante à l’environnement actif, utilisez env add :

stripe projects env add <name> --variable --env-key <ENV_KEY>

Pour retirer une variable de projet de l’environnement actif sans supprimer la variable sauvegardée, utilisez env remove :

stripe projects env remove <name> --variable

Stripe Projects préserve les clés d’environnement local qu’il ne gère pas.

Quand exécuter env --pull

env --pull s’exécute automatiquement après le provisionnement d’un service, la rotation des identifiants, la mise à niveau d’une ressource ou la modification de l’appartenance à un environnement. Vous n’avez pas besoin de l’exécuter manuellement dans ces cas.

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.
• Une variable de projet a été modifiée à distance et vous souhaitez mettre à jour son fichier de sortie local.

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.

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 :

stripe projects env list

Affichez l’environnement actif :

stripe projects env show

Créez un nouvel environnement et rendez-le actif :

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

Basculez l’environnement actif :

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é.

# 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 :

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

Supprimez un environnement :

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 :

stripe projects env add <resource_name>

Supprimez une ressource de l’environnement actif :

stripe projects env remove <resource_name>

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é :

stripe projects billing show

Ajouter ou mettre à jour un moyen de paiement

Ajoutez un moyen de paiement ou remplacez un moyen existant :

stripe projects billing add

Une fois que vous avez configuré un moyen de paiement, vous pouvez définir une limite de dépenses.

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.

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

Par défaut, la commande affiche les dépenses des 6 derniers mois. Utilisez --duration ou --since/--until pour modifier la période :

stripe projects spend --duration 3m

Utilisez --duration avec un nombre entier positif de mois ou de jours, comme 3m, 12m ou 90d. Utilisez all pour afficher les paiements depuis le 1er janvier 2026.

Utilisez --since ou --until avec une date au format YYYY-MM-DD. Vous pouvez utiliser chaque option séparément ou les deux ensemble. La commande inclut les mois civils complets contenant les dates. Par exemple, --since 2026-01-15 inclut tout le mois de janvier et --until 2026-03-10 inclut tout le mois de mars.

stripe projects spend --since 2026-01-15 --until 2026-03-10

Vous ne pouvez pas combiner --duration avec --since ou --until.

Pour afficher les dépenses d’un fournisseur spécifique :

stripe projects spend [provider]

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 applicable à chaque fournisseur, ou une limite par fournisseur pour plus de contrôle.

Stripe Projects applique chaque limite séparément à chaque fournisseur. Une limite globale correspond au plafond par défaut de chaque fournisseur, et non à un budget partagé entre tous les fournisseurs. Par exemple, si vous définissez une limite globale de 100 USD et utilisez trois fournisseurs, chacun peut facturer jusqu’à 100 USD, soit jusqu’à 300 USD de dépenses cumulées.

Exécutez la commande de manière interactive pour choisir le type de limite et saisir vos valeurs :

stripe projects billing update

Vous pouvez aussi inclure directement l’option --limit pour ignorer les invites. Pour définir une limite globale applicable à chaque fournisseur :

stripe projects billing update --limit <amount>

Pour définir une limite pour un fournisseur spécifique :

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

Les limites par fournisseur priment sur la limite globale lorsque les deux sont définies. Exécutez la commande une fois pour chaque fournisseur à plafonner individuellement. Par exemple, si vous définissez une limite globale de 100 USD et une limite de 20 USD pour un fournisseur, celui-ci peut facturer jusqu’à 20 USD et chacun des autres jusqu’à 100 USD.

Pour plafonner vos dépenses cumulées entre fournisseurs, définissez une limite pour chaque fournisseur de sorte que leur somme corresponde à votre budget total.

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 :

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 :

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 :

stripe projects init --from <URL>

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é :

stripe projects import <URL>

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.

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.

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