# Stripe Projects

> Provision and manage services from the CLI.

Stripe Projects lets you or your agents provision multiple services, generate and store credentials, and manage usage and billing from the CLI. Set up hosting, databases, auth, AI, analytics, and more in a few commands.

## Install the Agent Skill

To give your agent end-to-end provisioning capability, install the CLI, the plugin, and
the skill in one command:

```
npm install -g @stripe/cli@latest && stripe plugin install projects && npx skills add https://github.com/stripe/ai --skill stripe-projects -y -g
```

To add only the skill to an existing install:

```
npx skills add https://github.com/stripe/ai --skill stripe-projects -y -g
```

This skill drives the full workflow: verify provider → install CLI → install plugin → search catalog → init project → add service → hand off.

- Website: https://projects.dev
- Developer resources: https://projects.dev/developers/
- Provider catalog: https://projects.dev/providers/
- Documentation: https://docs.stripe.com/projects
- Install options: https://docs.stripe.com/stripe-cli/install
- Agent skill: https://projects.dev/skill.md

## Install CLI

Stripe Projects is a plugin for the Stripe CLI. Install both with:

```
npm install -g @stripe/cli@latest && stripe plugin install projects
```

On macOS, Homebrew works too:

```
brew install stripe/stripe-cli/stripe && stripe plugin install projects
```

For other install methods (Windows, Linux, Docker), see: https://docs.stripe.com/stripe-cli/install

## What It Does

Stripe Projects replaces the manual process of signing up for services, managing accounts, securing API keys, jumping between dashboards, and clicking through configuration pages. Instead, you provision and manage your entire software stack from the command line.

Key capabilities:

- **Programmatic**: One workflow to provision services, manage credentials, and upgrade plans, instead of different tools and workflows for every provider.
- **Billing**: Set up your billing details once and securely share them with your SaaS stack. Upgrade and downgrade tiers, monitor usage, and manage subscriptions from the CLI.
- **Portable**: Keep environment variables portable across local setups, machines, teammates, and agents.
- **Secure**: Generate, store, and return service credentials for both developers and agents.

## Supported Providers

Stripe Projects currently supports 65 providers. Provision any of them with
`stripe projects add <provider>/<service>`. Many providers span several categories; the
first listed is the primary one.

| Provider | Service slug | Categories |
|---|---|---|
| AgentMail | agentmail/api | Email, AI, Messaging |
| AgentPhone | agentphone/number | Communications |
| Algolia | algolia/application | Search, AI |
| Amplitude | amplitude/analytics | Analytics, AI, Feature flags |
| Athena AI | athena/agents | AI |
| Auth0/Okta | auth0/client | Auth |
| Base 44 | base44_projects/app | Hosting, AI, Auth, Database |
| Blaxel | blaxel/sandbox | Hosting, AI, Sandbox, Storage |
| Browserbase | browserbase/project | Browser |
| Chatbase | chatbase/agent | AI |
| Chroma | chroma/database | Database, AI |
| Churnkey | churnkey/retention | Payments |
| Clerk | clerk/auth | Auth |
| ClickHouse | clickhouse/clickhouse | Database, Analytics |
| Cloudflare | cloudflare/worker | Hosting, Database, Domains, Browser, Cache, Queue, Storage, AI |
| Composio | composio/project | AI |
| CreateOS | createos/project | Sandbox, Hosting |
| Customer.io | customer.io/workspace | Messaging, Email, Notifications |
| Datadog | datadog/observability | Observability |
| Daytona | daytona/sandbox | Sandbox, AI, Hosting |
| Depot | depot/api | CI, Cache, Hosting |
| E2B | e2b/sandboxes | Hosting, Sandbox |
| ElevenLabs | elevenlabs/tts | AI |
| Exa | exa/api | Search, AI |
| Firecrawl | firecrawl/api | Search |
| Fly.io | flyio/app | Hosting, Database |
| GitLab | gitlab/project | CI, AI, Analytics, CDN, Hosting, Observability, Storage |
| Here.now | herenow/hosting | Hosting, CDN, Storage |
| HeyGen | heygen/api | AI |
| Inngest | inngest/app | Queue |
| KERNEL | kernel/project | Browser, AI |
| Laravel Cloud | laravel_cloud/application | Hosting, Cache, Database |
| Metronome | metronome/sandbox | Payments |
| Mixpanel | mixpanel/analytics | Analytics |
| Neon | neon/postgres | Database, Auth |
| Netlify | netlify/project | Hosting |
| OpenRouter | openrouter/api | AI |
| Parallel | parallel/api | Search, AI |
| Perplexity | perplexity/api | Search, AI |
| PlanetScale | planetscale/postgresql | Database |
| PostalForm | postalform/mail | Communications |
| PostHog | posthog/analytics | Analytics, AI, Feature flags, Observability |
| Prisma | prisma/database | Database |
| Privy | privy/app | Payments, Auth |
| Pydantic | pydantic/logfire | Observability, AI, Analytics, Feature flags |
| Railway | railway/hosting | Hosting, Database, Cache, Storage |
| Render | render/static-site | Hosting, Database |
| RevenueCat | revenuecat/app | Payments, Analytics |
| Runloop | runloop/sandbox | Sandbox, AI |
| Schematic | schematic/schematic-environment | Feature flags |
| Sentry | sentry/project | Observability |
| Shopify | shopify/store | Ecommerce |
| Spaceship | spaceship/domain | Domains |
| Squarespace | squarespace/domain | Domains |
| Steel | steel/browser | Browser |
| Supabase | supabase/project | Database, Auth, Storage |
| Supermemory | supermemory/memory | AI, Database, Search, Storage |
| Tabstack | tabstack/api | Search, AI, Browser |
| Turso | turso/database | Database |
| Twilio | twilio/email | Communications, Email |
| Upstash | upstash/redis | Cache, Database, AI, Messaging, Search |
| Vercel | vercel/project | Hosting |
| Wix | wix/headless | Ecommerce |
| WordPress.com | wordpress.com/site | Hosting, Domains |
| WorkOS | workos/auth | Auth |

Browse the same catalog on the web at https://projects.dev/providers/, or from the CLI
with `stripe projects catalog`.

## CLI Commands

### Project lifecycle

```
stripe projects init [name]                # Create a project and sign in or register
stripe projects status                     # View project name, services, tiers, and health
stripe projects list                       # View all projects on your Stripe account
stripe projects pull <projectID>           # Set up an existing project in a new local directory
```

### Discovery

```
stripe projects catalog                    # List all available providers and services
stripe projects catalog <provider>         # Show services for a specific provider
stripe projects catalog <category>         # Show providers in a category
stripe projects search <keyword>           # Find provider services by keyword
```

### Provider management

```
stripe projects link <provider>            # Connect a provider to your project
stripe projects unlink <provider>          # Disconnect a provider from your project
stripe projects open <provider>            # Open a provider's dashboard in the browser
```

### Provisioning services

```
stripe projects add <provider>/<service>                # Provision a service
stripe projects add <provider>/<service> --name <n>     # Provision with a custom resource name
stripe projects add <provider>/<service> --config '<json>'  # Provision with configuration
stripe projects remove <provider>/<service>             # Deprovision and remove a service
stripe projects services list                           # List all services in a project
```

When you provision a service, Stripe Projects:
1. Creates the resource in the provider account you own
2. Generates credentials
3. Syncs credentials to your local environment (.env)
4. Stores configuration in .projects/

### Managing credentials

```
stripe projects env                        # View credentials (values hidden by default)
stripe projects env --pull                 # Update local .env and replenish credentials vault
stripe projects rotate <provider>/<service>  # Generate new credentials for a service
```

### Upgrades & billing

```
stripe projects upgrade <provider>/<service>    # Upgrade a service tier
stripe projects downgrade <provider>/<service>  # Downgrade to a lower tier or free plan
stripe projects update <provider>/<service>     # Modify a resource within the same provider
stripe projects billing add                     # Add or replace a payment method
stripe projects billing show                    # Display current payment method on file
stripe projects billing update                  # Modify payment method or adjust spend limit
```

### Sharing & collaboration

```
stripe projects share                      # Generate a shareable URL encoding your project's service stack
stripe projects import <URL>               # Add services from a shared stack to your project
stripe projects switch-account             # Change active Stripe account
```

### Context generation

```
stripe projects llm-context                # Generate a combined LLM context file
```

### Global flags

| Flag | Purpose |
|---|---|
| `-v, --version` | Display plugin version |
| `--json` | Output as structured JSON (easier for agents to parse) |
| `--no-interactive` | Disable prompts; fail if input is required |
| `--auto-confirm` | Accept confirmation dialogs automatically |
| `--quiet` | Suppress non-essential output |
| `--accept-tos` | Accept provider terms without prompting |
| `--stream` | Enable streaming output animations |
| `--debug` | Enable Stripe API request logging |

## Agent Usage

Stripe Projects is designed to be used by both developers and AI coding agents. Agents can:

1. Run `stripe projects status` to inspect the current project state.
2. Use `stripe projects catalog` to discover available services.
3. Provision services with `stripe projects add <provider>/<service>`.
4. Access credentials via `stripe projects env` or by reading the synced `.env` file.
5. Use the `--json` flag on any command for structured output that is easier to parse programmatically.
6. Use `--no-interactive --auto-confirm` to run without user prompts in automated workflows.

Important rules for agents:
- Never read or edit files in the `.projects/` directory directly. The CLI manages that state.
- Never read the `.env` file directly to discover what's available. Use `stripe projects env` instead.
- Commands can be run from the project root or any nested directory within the project.

### Drop-in agent skill

Install the skill directly:

```
npx skills add https://github.com/stripe/ai --skill stripe-projects -y -g
```

Or fetch https://projects.dev/skill.md and save it manually as `SKILL.md` inside `.claude/skills/stripe-projects-provision/` (or your agent's equivalent skills directory).

## Project Structure

Stripe Projects stores state in a `.projects/` directory:

| Path | Purpose | Commit? |
|---|---|---|
| `.projects/state.json` | Shared team project state | Yes |
| `.projects/state.local.json` | Personal provider account associations | Yes |
| `.projects/vault/vault.json` | Encrypted credential cache | No |
| `.projects/cache/` | CLI metadata cache | No |
| `.env` | Plaintext credentials for local dev | No |

## Deployment

To deploy a project provisioned with Stripe Projects, ensure these files are available on the remote host:

- `.projects/state.json`
- `.projects/state.local.json`
- Credentials from `stripe projects env --pull` (or the `.env` file)

Deploying may require provisioning a compute provider (e.g., Vercel or Railway) first.

## Developer Resources

The Stripe Projects developer resources index is at https://projects.dev/developers/. It
covers CLI install, the agent skill, the provider catalog, the site API, the error
format, and the versioning and deprecation policy.

## Machine-Readable Resources

Stripe Projects publishes these files at predictable URLs on https://projects.dev:

| URL | Format | Purpose |
|---|---|---|
| `/llms.txt` | text/plain | This file — curated overview for LLMs |
| `/skill.md` | text/markdown | Stripe Projects agent skill |
| `/.well-known/agent-skills/index.json` | application/json | Agent skill discovery document |
| `/index.html.md` | text/markdown | Markdown rendering of the home page |
| `/404.md` | text/markdown | Recovery pointers for unknown paths |
| `/auth.md` | text/markdown | Authentication status (no auth required) |
| `/.well-known/api-catalog` | application/linkset+json | RFC 9727 API discovery linkset |
| `/api/openapi.json` | application/openapi+json | OpenAPI 3.1 description of the site API |
| `/api/health` | application/json | Health check |
| `/sitemap.xml` | application/xml | Canonical URLs |
| `/robots.txt` | text/plain | Crawler access rules and content signals |
| `/.well-known/tdmrep.json` | application/json | TDM Reservation Protocol — mining and training permitted |

Requesting `/` with `Accept: text/markdown` returns `/index.html.md`.

## Content Usage

The public pages of https://projects.dev may be crawled, indexed, retrieved at
inference time, and used to train AI models. `/robots.txt` states this with
`Content-Signal: ai-train=yes, search=yes, ai-input=yes` and allows the training
crawlers by name; `/.well-known/tdmrep.json` states it as a TDMRep record with
`tdm-reservation: 0` (no rights reserved).

The one exception is `/s/` — those are generated stack-share links rather than
canonical pages, and every crawler group disallows them.

Trademarks, provider names, and provider logos remain the property of their owners,
and nothing here grants rights to content on other domains (including
https://docs.stripe.com). See https://stripe.com/legal for Stripe's terms.

## Authentication

The projects.dev website requires no authentication and publishes no OAuth or OpenID
Connect endpoints — see https://projects.dev/auth.md. Authenticated work happens in the
Stripe CLI against Stripe's API: https://docs.stripe.com/stripe-cli/login

## Site API Versioning

The site API is versioned by `info.version` in `/api/openapi.json` using semantic
versioning; paths are unversioned because the surface is read-only and additive.
Breaking changes are announced at least 90 days ahead with RFC 9745 `Deprecation` and
RFC 8594 `Sunset` headers. Full policy: https://projects.dev/developers/

Errors from `/api/` endpoints use RFC 9457 problem details
(`application/problem+json`); branch on the stable `code` field.

## Contact

- Provider partnership inquiries: provider-request@stripe.com
- Documentation: https://docs.stripe.com/projects
- Privacy & Terms: https://stripe.com/privacy