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

```
install https://projects.dev/skill.md
```

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

- Website: https://projects.dev
- 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:

```
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 the following providers and services:

| Provider | Service slug | Category |
|---|---|---|
| AgentMail | agentmail/api | Communications |
| Algolia | algolia/application | Search |
| Amplitude | amplitude/analytics | Analytics, Feature Flags |
| Auth0/Okta | auth0/client | Auth |
| Browserbase | browserbase/project | Browser, AI |
| Chroma | chroma/database | Database, AI |
| Clerk | clerk/auth | Auth |
| Cloudflare | cloudflare/worker | Hosting, Database, Storage, Domains, Cache, Queues |
| Daytona | daytona/sandbox | Sandbox, Hosting |
| ElevenLabs | elevenlabs/tts | AI |
| Firecrawl | firecrawl/api | Search |
| Fly.io | flyio/app | Hosting, Database |
| GitLab | gitlab/project | CI/CD, Observability, Storage |
| Hugging Face | huggingface/platform | AI, Hosting, Storage |
| Inngest | inngest/app | Queues |
| Mixpanel | mixpanel/analytics | Analytics |
| Neon | neon/postgres | Database, Auth |
| Netlify | netlify/project | Hosting |
| OpenRouter | openrouter/api | AI |
| PlanetScale | planetscale/postgresql | Database |
| PostHog | posthog/analytics | Analytics, Feature Flags |
| Privy | privy/app | Payments, Auth |
| Railway | railway/hosting | Hosting, Database, Storage, Cache |
| Render | render/static-site | Hosting, Database |
| Runloop | runloop/sandbox | Sandbox, AI |
| Sentry | sentry/project | Observability |
| Squarespace | squarespace/domain | Domains |
| Supabase | supabase/project | Database, Auth, Storage |
| Turso | turso/database | Database |
| Twilio | twilio/email | Communications |
| Upstash | upstash/redis | Cache, Search, Database |
| Vercel | vercel/project | Hosting |
| WorkOS | workos/auth | Auth |

Run `stripe projects catalog` at any time to view the most current list of providers and services.

More providers are being added. To suggest a provider, email provider-request@stripe.com.

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

```
install https://projects.dev/skill.md
```

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

## Contact

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