-
Notifications
You must be signed in to change notification settings - Fork 9
Add Stripe Projects docs for llm_context #389
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
Merged
Changes from all commits
Commits
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,66 @@ | ||
| --- | ||
| title: "Stripe Projects — browser API access" | ||
| description: "LLM context for the kernel/browser:api-access Stripe Projects service" | ||
| --- | ||
|
|
||
| This page describes the **`kernel/browser:api-access`** deployable service provisioned through Stripe Projects. | ||
|
|
||
| ## What this resource is | ||
|
|
||
| A **project-scoped Kernel API key** used to create and manage cloud browsers (CDP, Playwright, Computer Controls, etc.) for that Stripe Project’s Kernel project. | ||
|
|
||
| ## Provisioning | ||
|
|
||
| ```bash | ||
| stripe projects add kernel/browser:api-access --config '{"name":"production"}' | ||
| stripe projects env --pull | ||
| ``` | ||
|
|
||
| ### Configuration | ||
|
|
||
| | Field | Type | Required | Description | | ||
| |-------|------|----------|-------------| | ||
| | `name` | string | yes | Label for the API key (e.g. `production`, `staging`) | | ||
|
|
||
| ## After provisioning | ||
|
|
||
| 1. Run `stripe projects env --pull` to sync credentials into `.env` / `.projects/vault`. | ||
| 2. Use the Kernel API key from the environment (typically `KERNEL_API_KEY`) with the SDK or CLI. | ||
|
|
||
| ```typescript | ||
| import Kernel from '@onkernel/sdk'; | ||
|
|
||
| const kernel = new Kernel(); // uses KERNEL_API_KEY from env | ||
|
|
||
| const browser = await kernel.browsers.create(); | ||
| ``` | ||
|
|
||
| ```bash | ||
| kernel browsers create | ||
| ``` | ||
|
|
||
| ## Pricing | ||
|
|
||
| | Situation | Price | | ||
| |-----------|--------| | ||
| | No active Kernel plan on the org | Usage-based: **$0.01/min** (standard), **$0.02/min** (stealth) | | ||
| | Active `plan:developer`, `plan:hobbyist`, or `plan:startup` | **Included** with plan (component pricing `free` under parent plan) | | ||
|
|
||
| Provision a plan first when the developer needs predictable monthly credits and concurrency limits. | ||
|
|
||
| ## Operations | ||
|
|
||
| ```bash | ||
| # Rotate credentials (invalidates old key) | ||
| stripe projects rotate kernel/browser:api-access | ||
|
|
||
| # Remove the resource | ||
| stripe projects remove kernel/browser:api-access | ||
| ``` | ||
|
|
||
| ## Further reading | ||
|
|
||
| - [Stripe Projects (provider overview)](/integrations/stripe-projects) | ||
| - [Create a browser](https://kernel.sh/docs/introduction/create) | ||
| - [API keys](https://kernel.sh/docs/info/api-keys) | ||
| - [Projects](https://kernel.sh/docs/info/projects) |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,84 @@ | ||
| --- | ||
| title: "Stripe Projects" | ||
| description: "Provision Kernel cloud browsers and plans through the Stripe Projects CLI" | ||
| --- | ||
|
|
||
| Kernel is a Stripe Projects provider. Use the Stripe CLI to link your Kernel account, choose a plan, and provision per-project API keys without using the dashboard for setup. | ||
|
|
||
| This page is the provider-level LLM context for agents (`stripe projects llm-context`). Service-specific guidance for cloud browser API keys is in [Stripe Projects — browser API access](/integrations/stripe-projects-browser). | ||
|
|
||
| ## Service catalog | ||
|
|
||
| Stripe service slugs are prefixed with `kernel/` (from the app manifest name). | ||
|
|
||
| | Service ID | Kind | Scope | Summary | | ||
| |------------|------|-------|---------| | ||
| | `kernel/plan:developer` | plan | account | Free tier — $5/mo credits, 5 concurrent browsers | | ||
| | `kernel/plan:hobbyist` | plan | account | $30/mo, $10/mo credits, 10 concurrent browsers (email KYC) | | ||
| | `kernel/plan:startup` | plan | account | $200/mo, $50/mo credits, 150 concurrent browsers (email KYC) | | ||
| | `kernel/browser:api-access` | deployable | project | API key for launching browsers in a Stripe Project | | ||
|
|
||
| - Only **one plan** can be active per Kernel org at a time (`allowed_updates` defines upgrade/downgrade paths). | ||
| - `browser:api-access` is **free** when any active plan is provisioned; otherwise it is usage-based ($0.01/min standard, $0.02/min stealth). | ||
|
|
||
| ## Common CLI flows | ||
|
|
||
| ```bash | ||
| # Link Kernel to your Stripe Projects workspace | ||
| stripe projects link kernel | ||
|
|
||
| # Browse the catalog (confirm exact slugs before provisioning) | ||
| stripe projects services list | ||
|
|
||
| # Provision a paid plan (requires verified email / KYC) | ||
| stripe projects add kernel/plan:hobbyist | ||
| stripe projects add kernel/plan:startup | ||
|
|
||
| # Provision a project-scoped API key (configuration: {"name": "production"}) | ||
| stripe projects add kernel/browser:api-access --config '{"name":"production"}' | ||
|
|
||
| # Sync credentials into .env | ||
| stripe projects env --pull | ||
|
|
||
| # Rotate API key credentials | ||
| stripe projects rotate kernel/browser:api-access | ||
|
|
||
| # Open the Kernel dashboard | ||
| stripe projects open kernel --purpose dashboard | ||
| ``` | ||
|
|
||
| Run `stripe projects services list` and copy the **exact** service slug from the output before `stripe projects add` — do not guess slugs. | ||
|
|
||
| ## Account and project mapping | ||
|
|
||
| | Stripe | Kernel | | ||
| |--------|--------| | ||
| | Stripe account | Kernel organization (billing + linking) | | ||
| | Stripe Project | Kernel project (API keys, sessions, pools, etc.) | | ||
| | Plan resources | Org-wide subscription tier | | ||
| | `browser:api-access` | Project-scoped API key | | ||
|
|
||
| Each Stripe Project maps 1:1 to a Kernel project within the org. Resources provisioned for a new `project_id` create a Kernel project if needed. | ||
|
|
||
| ## Authentication | ||
|
|
||
| New accounts use the **agentic credentials** flow: after `stripe projects link` / account request, Kernel returns bearer access and refresh tokens. Use `stripe projects env --pull` to load credentials locally. | ||
|
|
||
| - **Dashboard (humans):** https://dashboard.onkernel.com | ||
| - **Existing Kernel customers** with billing already on file may receive `payment_credentials: "provider"` when linking to avoid double-billing. | ||
|
|
||
| ## Billing and Shared Payment Tokens (SPT) | ||
|
|
||
| Paid plans are charged through Stripe **Shared Payment Tokens** on the Metronome-managed Stripe customer. | ||
|
|
||
| <Warning> | ||
| The default SPT monthly spending limit is often **$50**. The Start-Up plan is **$200/mo**. Before upgrading to Start-Up, confirm the developer’s SPT limit covers the plan (`stripe projects billing show`) or ask them to raise the limit. Charges above the limit will fail. | ||
| </Warning> | ||
|
|
||
| ## Full documentation | ||
|
|
||
| - Doc index for agents: https://kernel.sh/docs/llms.txt | ||
| - Create and connect browsers: https://kernel.sh/docs/introduction/create | ||
| - API keys: https://kernel.sh/docs/info/api-keys | ||
| - Pricing: https://kernel.sh/docs/info/pricing | ||
| - Cursor / Claude skills: https://github.com/kernel/skills | ||
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Specific third-party product names on unrelated integration page
Low Severity
The link label
Cursor / Claude skillsreferences specific third-party AI products by name. This page is a Stripe Projects integration page — the rule's exception for integration pages only covers references to the specific product being integrated (Stripe Projects), not unrelated products. A vendor-neutral label like "Agent skills" or "Coding agent skills" conveys the same meaning without naming specific tools.Triggered by learned rule: Use generic terms instead of specific third-party AI product names
Reviewed by Cursor Bugbot for commit 39d669c. Configure here.