Skip to content

Commit 2143f36

Browse files
hongyi-chenoz-agentrachaelrenk
authored
docs: add Platform Credits page and three-bucket model (#83)
* docs: add Platform Credits page and three-bucket model Adds a new conceptual page introducing Platform Credits as the third credit bucket in Warp, alongside AI credits and Cloud Agent Credits. Explains when Platform Credits apply (cloud agents on any plan, and local agents on Business/Enterprise with BYOK or BYOLLM inference), when they don't, and where they appear in usage views. Also updates the existing Credits and Plans pages to introduce the three-bucket model and cross-link to the new page. Pricing specifics are deferred to warp.dev/pricing. Co-Authored-By: Oz <oz-agent@warp.dev> * docs(platform-credits): align charge matrix and tighten copy - Fix contradiction flagged in PR #83 review: cloud agents always charge Platform Credits regardless of inference source. Reframe intro, three- bucket section, and the multi-bucket example to match the matrix in 'When Platform Credits apply'. - Point Generate link at /agent-platform/local-agents/generate/. - Remove time-unit details from the rate section; defer to warp.dev/pricing. - Drop internal tooltip-label callouts from the admin section. - Tighten plans-pricing-refunds Platform Credits one-liner to match. Co-Authored-By: Oz <oz-agent@warp.dev> * docs: reframe Platform Credits around inference / compute / platform infrastructure Per review feedback, lead with the three-infrastructure framing (inference, compute, platform) rather than the orchestration-layer framing. Each credit bucket now names the kind of infrastructure it covers. Also drop the enterprise custom-rate sentence; warp.dev/pricing remains the source of truth for rates. Co-Authored-By: Oz <oz-agent@warp.dev> * docs(platform-credits): address audit findings - Reframe Platform Credits intro to lead with the rule (every cloud agent run, plus Business/Enterprise local agent runs with customer-supplied inference) instead of the negative 'when Warp isn't paying' framing. - Align cross-file framing in credits.mdx and plans-pricing-refunds.mdx so all three pages describe Platform Credits in the same terms. - Replace 'Workflow autofill' with linked 'AI Autofill'. - Replace 'Local Oz runs' with 'local agent runs' (Oz run is cloud-only). - Deduplicate the second BYOK parenthetical and normalize BYOLLM wording. - Clarify that self-hosted cloud workers count as cloud agents for Platform Credits purposes. Co-Authored-By: Oz <oz-agent@warp.dev> * Update src/content/docs/support-and-community/plans-and-billing/platform-credits.mdx Co-authored-by: Rachael Rose Renk <91027132+rachaelrenk@users.noreply.github.com> * Update src/content/docs/support-and-community/plans-and-billing/platform-credits.mdx Co-authored-by: Rachael Rose Renk <91027132+rachaelrenk@users.noreply.github.com> * docs(platform-credits): apply Rachael's wording suggestions Address remaining suggested edits from Rachael's review on PR #83: - plans-pricing-refunds.mdx: rewrite Platform Credits bullet to action-oriented form, matching sibling bullets. - platform-credits.mdx: de-dupe "charge for" repetition in intro; convert three-bucket bullets to active-voice complete sentences; rewrite "When Platform Credits apply" with "Uses Platform Credits" / "Doesn't use Platform Credits" headers and complete-sentence bullets; replace internal "harness" jargon with "which agent runs the task"; rename "Third-party harnesses run directly" to "Third-party agent CLIs run directly". - credits.mdx: same active-voice and "agent CLI" updates in the three-bucket summary and Platform Credits subsection. Validation: style_lint --changed clean (9 files, 0 issues), check_links --internal-only clean (2435 links, 0 broken). Co-Authored-By: Oz <oz-agent@warp.dev> * docs(platform-credits): reframe Cloud Agent Credits as compute bucket + add BYOK TOS rule Two pieces of feedback addressed on PR #83. 1. Cloud Agent Credits reframing. The bucket is described as compute infrastructure consumed by any agent run, local or cloud. Local agents rarely draw from it in practice because they don't run on Warp's compute, but the credit type is no longer tied to 'cloud-only by construction.' Updated: - platform-credits.mdx three-bucket bullet for Cloud Agent Credits (was 'cover compute infrastructure when cloud agents run on Warp-hosted compute,' now 'are the compute bucket... cover Warp-hosted compute consumed by any agent run, local or cloud'). - credits.mdx three-bucket bullet for Cloud Agent Credits with the same framing. - credits.mdx ### Cloud Agent Credits section intro reframed as 'the compute credits bucket - consumed when an agent run uses Warp-hosted compute. Both local and cloud agent runs can in principle draw from this pool...' - credits.mdx 'Not eligible' list intro tightened to make the reason explicit ('because they don't run on Warp-hosted compute') instead of implying the credit type is fundamentally cloud-only. 2. BYOK / customer-supplied inference TOS rule. Surfaces Warp's TOS rule wherever BYOK or customer-supplied inference is invoked as a workaround for Warp-paid inference. Added: - :::caution callout in platform-credits.mdx after the customer-supplied-inference paragraph, stating the individuals-and-organizations <=10 users rule and the Business or Enterprise requirement for orgs >10 users. Links to the canonical https://www.warp.dev/terms-of-service. - One-line forward reference at the end of the 'Local agents on Business or Enterprise with customer-supplied inference' bullet in platform-credits.mdx, pointing readers back to the callout for plan-size eligibility. - :::caution callout in bring-your-own-api-key.mdx directly after the existing :::note about BYOK paid-plan availability. - One-sentence summary of the TOS rule in the 'BYOK on Enterprise and Business plans' section, so admins reading that section see the eligibility constraint. Out of scope: renaming the 'Cloud Agent Credits' product term, changing pricing-faqs.mdx, or reworking BYOLLM enterprise gating (BYOLLM is already Enterprise-only, so the TOS rule is implicit). Validation: - style_lint --changed: 0 issues across 9 files scanned. - check_links --internal-only: 0 broken links across 319 files and 2,435 internal links. Co-Authored-By: Oz <oz-agent@warp.dev> * docs(platform-credits): holistic polish pass after the compute/TOS reframe Tightens stale framing and copy that fell out of alignment after the last commit reframed Cloud Agent Credits as the compute bucket. credits.mdx: - Drop the orphaned 'small hosting fee, charged only when running agents in the cloud' sentence in the opener (L13). It predates the three-bucket model and now contradicts the new framing immediately below it; the bullet at the new L16 covers the same ground correctly. - Reframe the 'Cloud Agent Credits' bullet in Credit limits and billing (was L47, now L45). The old wording ('their normal Warp credits, Cloud Agent Credits, or a Build plan with available credits') treated Cloud Agent Credits as a separate currency. Rewritten as 'Cloud agents and integrations: Individual users can run cloud agents via the CLI and API, drawing from their plan credits. Slack and Linear integrations require team membership.' - Tighten 'in principle draw from this pool' to 'are eligible to draw from this pool' in the Cloud Agent Credits section intro (L122). platform-credits.mdx: - Frontmatter description shortened from 219 to 144 chars (back in the 50-160 SEO range). - Drop the redundant second sentence on L13 ('Platform Credits don't apply to local runs on Free, Build, or Max plans...'). The Doesn't use section below already covers it. The first sentence (defining customer-supplied inference) stays since the TOS callout depends on it. - Align the Admin usage breakdown bullet (L55): 'distinct from the AI and Compute segments' -> 'distinct from the AI credits and Cloud Agent Credits segments'. Uses the bucket names consistently with the rest of the page. Validation: - style_lint --changed: 2 pre-existing warnings on bring-your-own-api-key.mdx (Zero Data Retention is a proper term; Enterprise/Business are proper plan names). Acceptable. - check_links --internal-only: 0 broken links across 319 files and 2,433 internal links. Co-Authored-By: Oz <oz-agent@warp.dev> * docs(platform-credits): rename Cloud Agent Credits -> compute credits + reframe as orthogonal credit-type/host model Per user correction: the credit type is 'compute credits' (lowercase), not 'Cloud Agent Credits.' The old name conflated the credit type (compute) with the host (cloud). The corrected conceptual model treats the three credit types (AI/inference, compute, platform) and the two host types (local, cloud) as orthogonal dimensions: any credit type can in principle apply to any host, with compute credits being the one that in practice only cloud agents consume (because local agents run on the user's machine). Files touched: Content (6): - credits.mdx: three-bucket bullets reframed to lead with the orthogonal dimension; section heading '### Cloud Agent Credits' -> '### Compute credits'; section intro rewritten; eligible/not- eligible subheadings renamed; all inline mentions and the '#cloud-agent-credits' anchor flipped to '#compute-credits'. - platform-credits.mdx: page intro three-bucket sentence updated to use 'compute credits'; three-bucket bullets reframed with the orthogonal-dimension intro; multi-bucket example updated; per-user and admin breakdown bullets updated to use bucket names consistently. - team-access-billing-and-identity.mdx: 3 references reworded to drop the 'normal Warp credits, Cloud Agent Credits, or a Build plan' stale enumeration and use plan credits / compute credits. - agent-platform/cloud-agents/overview.mdx: 2 references updated to the new terminology + anchor. - enterprise/support-and-resources/billing.mdx: 'small hosting fee' framing replaced with the explicit three-bucket model; 'no separate cloud agent credits or local credits' sentence replaced with a framing that aligns with the bucket model (credit type depends on infrastructure, not on local vs cloud). - terminal-and-agent-modes.mdx: Credits indicator description generalized from 'remaining cloud agent credits' to 'remaining credits.' Support / glossary (3): - AGENTS.md: 'Cloud Agent Credits' entry replaced with 'compute credits' (lowercase) entry; new 'Platform Credits' entry added (was previously implicit). - .agents/references/terminology.md: same swap in the billing glossary. - .agents/skills/style_lint/style_lint.py: 'Cloud Agent Credits' removed from PROPER_FEATURE_NAMES (no longer a Title-Case exception since it's now lowercase); 'Platform Credits' added to PROPER_FEATURE_NAMES; PRODUCT_CASING gains 'Cloud Agent Credits' -> 'compute credits' and 'Cloud Agent Credit' (singular) as one-way nudges so future contributors don't reintroduce the old name. Validation: - 0 remaining 'Cloud Agent Credit' or '#cloud-agent-credit' references in src/content/docs. - style_lint --changed: only the 2 pre-existing BYOK warnings (Zero Data Retention, BYOK on Enterprise and Business plans). Both are acceptable false positives flagged in prior commits. - check_links --internal-only: 0 broken across 319 files and 2,434 internal links. The Astro Starlight heading-to-anchor derivation (### Compute credits -> #compute-credits) resolves correctly. Out of scope: - Lowercasing 'Platform Credits' (user did not request). - Changes to pricing-faqs.mdx (no mentions). - vercel.json redirects (anchors aren't redirected; all inbound refs in our own docs were updated directly). Co-Authored-By: Oz <oz-agent@warp.dev> * docs: normalize credits list separators Co-Authored-By: Oz <oz-agent@warp.dev> * docs(platform-credits): restore descriptive 'cloud agent credits' on the Credits indicator UI label In the prior rename pass I over-corrected one spot: the 'Credits indicator' UI label in terminal-and-agent-modes.mdx, which described the cloud agent conversation's credit-balance indicator. The original text 'Shows your remaining cloud agent credits' was using 'cloud agent credits' descriptively (as in 'the credits cloud agents consume'), not as a formal product-name reference. Restoring the original wording. The PRODUCT_CASING lint nudge is case-sensitive on Title Case 'Cloud Agent Credits' / 'Cloud Agent Credit', so descriptive lowercase mentions like this one don't trigger it. Co-Authored-By: Oz <oz-agent@warp.dev> * docs(platform-credits): revert compute credits rename back to Cloud Agent Credits Per user feedback: the product name is 'Cloud Agent Credits' (Title Case). The word 'compute' is the type description (what the bucket covers - the sandbox an agent runs in), not the product name. My prior rename pass conflated the two. Revert it. Kept from the prior pass: - The orthogonal credit-type/host conceptual reframe: 'Credit types and where an agent runs (local or cloud) are independent. Each agent run consumes from whichever credit types apply to it.' This framing was an improvement and stays. - The Enterprise billing page rewrite: the old 'small hosting fee' framing and the contradicting 'no separate cloud agent credits or local credits' sentence stay replaced by the explicit three-bucket explanation. Just substituted 'Cloud Agent Credits' back for the product-name reference. - The BYOK / customer-supplied inference TOS callouts in platform-credits.mdx and bring-your-own-api-key.mdx. - The Platform Credits glossary entry I added to AGENTS.md and terminology.md (was a real gap, not added by mistake). - The descriptive lowercase 'cloud agent credits' in terminal-and-agent-modes.mdx:126 (UI label restoration in 8833ded). Reverted: - credits.mdx: three-bucket bullets, section heading '### Compute credits' -> '### Cloud Agent Credits', section intro, eligible / not-eligible subheadings and intros. - platform-credits.mdx: page intro three-bucket sentence, three-bucket bullets, multi-bucket example, per-user and admin breakdown bullets. - team-access-billing-and-identity.mdx: 3 references and anchor link. - cloud-agents/overview.mdx: 2 references and anchors. - enterprise/support-and-resources/billing.mdx: product-name swap. - AGENTS.md: glossary entry back to 'Cloud Agent Credits'. - terminology.md: same. - style_lint.py: 'Cloud Agent Credits' back in PROPER_FEATURE_NAMES; removed the two PRODUCT_CASING nudges for Cloud Agent Credits -> compute credits. Validation: - 0 'compute credits' product-name references remain in src/content/docs. - style_lint --changed: only the 2 pre-existing BYOK header false positives. - check_links --internal-only: 0 broken across 319 files and 2,434 internal links. The '#cloud-agent-credits' anchor resolves via the restored '### Cloud Agent Credits' heading. Co-Authored-By: Oz <oz-agent@warp.dev> * docs: add Platform Credits AEO summary Co-Authored-By: Oz <oz-agent@warp.dev> * Split Cloud Agent Credits into Compute credits + Cloud agent credits; rename plan credits to normal Warp credits Address review feedback: 1. Split into two complementary concepts: - **Compute credits** (sentence case): the compute bucket itself, used alongside AI credits and Platform Credits when describing credit types. - **Cloud agent credits** (sentence case, 'Cloud' capitalized): credits consumed by cloud agents, in contrast with local agent credits. Both refer to the same underlying bucket; pick the term that fits the framing. 2. Rename 'plan credits' to 'normal Warp credits' in user-facing copy so it's no longer confused with 'Build plan credits' (the proper plan product noun, which is preserved). Files updated: - credits.mdx: Three-bucket bullets use 'Compute credits'. Section heading '### Cloud Agent Credits' becomes '### Compute credits' with anchor '#compute-credits', plus eligible/not-eligible subheadings switch to 'compute credits'. A short note explains the 'Cloud agent credits' alias for the host-context framing. - platform-credits.mdx: Bucket-context bullets and per-user/admin breakdown switch to 'Compute credits' (bucket framing) plus the three-bucket intro sentence. - team-access-billing-and-identity.mdx, cloud-agents/overview.mdx: Cloud-vs-local-host bullets use 'Cloud agent credits' (sentence case) pointing to '#compute-credits'. - enterprise/support-and-resources/billing.mdx: Three-bucket framing uses 'compute credits' alongside AI and Platform Credits. - add-on-credits.mdx, pricing-faqs.mdx: 'plan credits' (legacy term) swapped for 'normal Warp credits'; 'Build plan credits' (proper noun) is preserved. - AGENTS.md, .agents/references/terminology.md: Glossary updated with both 'Compute credits' and 'Cloud agent credits' entries, and the 'normal Warp credits' guidance. - .agents/skills/style_lint/style_lint.py: Removes 'Cloud Agent Credits' from PROPER_FEATURE_NAMES and adds a nudge to use sentence case ('Cloud agent credits') or 'compute credits' depending on framing. Validation: - 0 'Cloud Agent Credits' Title Case occurrences in src/content/docs - All 3 remaining 'plan credits' matches are 'Build plan credits' - style_lint --changed: only pre-existing BYOK false positives - check_links --internal-only: 0 broken across 2,434 internal links - '#compute-credits' anchor resolves via renamed section heading Co-Authored-By: Oz <oz-agent@warp.dev> * Lowercase 'cloud agent credits' mid-sentence/mid-bullet Per review feedback: the term 'cloud agent credits' is a common noun and should be lowercased anywhere it appears mid-sentence or mid-bullet. Only capitalize the first letter at the start of a sentence or bullet. Files updated: - credits.mdx L124: the alias clarification ('referred to as **cloud agent credits**') is now lowercase. - team-access-billing-and-identity.mdx L21, L41, L84: all three are mid-bullet/mid-sentence references and are lowercased. - cloud-agents/overview.mdx L120, L135: mid-bullet references lowercased. - AGENTS.md, .agents/references/terminology.md: glossary entry header is now '**cloud agent credits**' (lowercase) to match the canonical form for common-noun terms (consistent with **credits**, **normal Warp credits**, etc.). The description was updated to explain when to capitalize. - .agents/skills/style_lint/style_lint.py: PRODUCT_CASING nudge now recommends lowercase 'cloud agent credits' with a note about capitalizing the first letter at sentence/bullet boundaries. Glossary entries that lead a bullet (e.g. '**cloud agent credits**') stay lowercase to follow the existing common-noun convention in terminology.md, not because they're mid-sentence. Co-Authored-By: Oz <oz-agent@warp.dev> * Lowercase 'platform credits' mid-sentence/mid-bullet/mid-heading Per review feedback, apply the same common-noun convention to 'platform credits' that we applied to 'cloud agent credits' and 'compute credits'. Capitalize the first letter only at the start of a sentence, bullet, or heading; lowercase everywhere else. Files updated: - platform-credits.mdx: title -> 'Platform credits'. Every body, bullet, and heading occurrence reframed: - Three-bucket bullets and mid-sentence text -> 'platform credits' / '**Platform credits**' (bullet leads stay sentence-cased). - All H2/H3 headings ('## How platform credits are measured', '## When platform credits apply', '### Uses platform credits', '### Doesn't use platform credits', '## Where platform credits appear') lowercase the second word. - credits.mdx: three-bucket bullet, section heading '### Platform credits', subsection headings, and all in-text occurrences updated. Mid-sentence link text 'See [platform credits](...)' is also lowercased. - enterprise/support-and-resources/billing.mdx: the example sentence the reviewer flagged ('...AI credits..., compute credits..., and platform credits for the orchestration layer') and the three-types parenthetical (AI credits, compute credits, and platform credits) are lowercased. - plans-pricing-refunds.mdx: the related-links bullet now reads '[Platform credits](...) - learn how platform credits cover...'. - AGENTS.md, .agents/references/terminology.md: glossary entry header is now '**platform credits**' (matching the existing common-noun convention used for **credits**, **normal Warp credits**, **compute credits**, **cloud agent credits**) with a usage note explaining the casing rule. Adjacent **compute credits** entry is normalized the same way. - .agents/skills/style_lint/style_lint.py: 'Platform Credits' removed from PROPER_FEATURE_NAMES and a new PRODUCT_CASING nudge maps the title-cased form to lowercase 'platform credits' with a note about capitalizing at sentence/bullet/heading boundaries. Validation: - check_links --internal-only: 0 broken across 2,434 internal links. - The only remaining 'Platform Credits' Title Case match is the linter's own wrong->right mapping (expected). Co-Authored-By: Oz <oz-agent@warp.dev> * docs: rename 'normal Warp credits' to 'Warp credits' Drops the 'normal' qualifier across user-facing copy, the terminology glossary, and AGENTS.md. 'Warp credits' is the cleaner brand-aligned term for credits included with a subscription plan. Co-Authored-By: Oz <oz-agent@warp.dev> * docs: polish credit copy after rename - Drop now-redundant 'or Build plan credits' / 'or a Build plan with available credits' (Build plan credits are Warp credits). - Tighten 'individual Warp credits' to 'individual credits' to match the prior bullet's wording. - Remove duplicate 'Warp' in 'your included monthly Warp credits'. - Replace 'Build plan credits' with [Add-on Credits] in the cloud-agents requirements bullet so it mirrors the team-requirements bullet below it. - Restructure the Add-on Credits/limits sentence in platform-credits.mdx to make the consumption order explicit. - Update 'same plan credit pool' to 'same Warp credit pool' in credits.mdx. Co-Authored-By: Oz <oz-agent@warp.dev> * docs: drop redundant credit-type enumerations The '(any type works)' parenthetical and the 'Warp credits, cloud agent credits, and Add-on Credits all work' bullet aren't actually telling the user anything actionable — they're all credits and they all draw from the same balance. Just say '20 credits' and let the linked billing pages handle the credit-type breakdown. Touched: - agent-platform/cloud-agents/overview.mdx (2 occurrences; removed the redundant credit-type bullet under Credit requirements as well as the vague 'Usage is billed based on credit type and team configuration' filler bullet). - agent-platform/cloud-agents/team-access-billing-and-identity.mdx (2). - agent-platform/cloud-agents/quickstart.mdx (1). - agent-platform/cloud-agents/integrations/slack.mdx (1). - agent-platform/cloud-agents/integrations/linear.mdx (1). Co-Authored-By: Oz <oz-agent@warp.dev> --------- Co-authored-by: Oz <oz-agent@warp.dev> Co-authored-by: Rachael Rose Renk <91027132+rachaelrenk@users.noreply.github.com>
1 parent 9375a44 commit 2143f36

15 files changed

Lines changed: 143 additions & 38 deletions

File tree

.agents/references/terminology.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -231,9 +231,11 @@ For the summary of the most critical terms (core features, Oz terms, terms to av
231231
## Billing and credits
232232

233233
- **Add-on Credits** — capitalized as a product feature name
234-
- **Cloud Agent Credits** — capitalized as a billing feature name
234+
- **compute credits** — lowercase common noun; capitalize the first letter only at the start of a sentence or bullet. The compute bucket, consumed when an agent run uses Warp-hosted compute. Use alongside AI credits and platform credits when describing credit types.
235+
- **cloud agent credits** — lowercase common noun; capitalize the first letter only at the start of a sentence or bullet. Credits consumed by cloud agents, in contrast with local agent credits. Refers to the same compute bucket as compute credits; choose the term that fits the framing.
236+
- **platform credits** — lowercase common noun; capitalize the first letter only at the start of a sentence or bullet. The platform-infrastructure bucket, consumed for every cloud agent run plus local runs with customer-supplied inference.
235237
- **credits** — the unit of usage for AI features in Warp (lowercase, not "AI credits")
236-
- **plan credits** — credits included with a subscription plan
238+
- **Warp credits** — credits included with a subscription plan. Use in user-facing copy rather than "plan credits."
237239

238240
## External product names
239241

.agents/skills/style_lint/style_lint.py

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -35,15 +35,18 @@
3535
# Feature names that are correctly Title Case (exceptions to sentence-case rule)
3636
PROPER_FEATURE_NAMES = {
3737
"Admin Panel", "Agent Management Panel", "Agent Mode", "Agent Profiles",
38-
"Ambient Agents", "Auto-detection Mode", "Cloud Agent Credits",
38+
"Ambient Agents", "Auto-detection Mode",
3939
"Codebase Context", "Code Review", "Command Palette", "Global Rules",
40-
"Oz CLI", "Oz Platform", "Project Rules", "Slash Commands",
41-
"Terminal Mode", "Universal Input", "Warp Drive", "Warp Platform",
40+
"Oz CLI", "Oz Platform", "Project Rules",
41+
"Slash Commands", "Terminal Mode", "Universal Input", "Warp Drive",
42+
"Warp Platform",
4243
}
4344

4445
# Terminology: wrong → right (case-sensitive checks)
4546
PRODUCT_CASING = {
4647
"Warp Terminal": ("Warp", "Use 'Warp' unless specifically distinguishing from Oz"),
48+
"Cloud Agent Credits": ("cloud agent credits", "Use lowercase 'cloud agent credits' (host-context) or 'compute credits' (bucket-context); capitalize first letter only at start of a sentence/bullet"),
49+
"Platform Credits": ("platform credits", "Use lowercase 'platform credits'; capitalize first letter only at start of a sentence/bullet/heading"),
4750
"agent mode": ("Agent Mode", "Capitalize as a feature name"),
4851
"agent management panel": ("Agent Management Panel", "Capitalize as a UI surface name"),
4952
"warp drive": ("Warp Drive", "Capitalize as a feature name"),

AGENTS.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -610,8 +610,10 @@ Product feature names retain their standard capitalization. Match the exact casi
610610
### Billing and credits
611611
- **credits** (lowercase, not "AI credits") - the unit of usage for AI features in Warp
612612
- **Add-on Credits** (capitalized as a product feature name)
613-
- **Cloud Agent Credits** (capitalized as a billing feature name)
614-
- **plan credits** - credits included with a subscription plan
613+
- **compute credits** (lowercase common noun; capitalize the first letter only at the start of a sentence or bullet) - the compute bucket; consumed when an agent run uses Warp-hosted compute. Used alongside AI credits and platform credits when describing credit types.
614+
- **cloud agent credits** (lowercase common noun; capitalize the first letter only at the start of a sentence or bullet) - credits consumed by cloud agents (in contrast with local agent credits). Refers to the same compute bucket as compute credits; pick the term that fits the framing.
615+
- **platform credits** (lowercase common noun; capitalize the first letter only at the start of a sentence or bullet) - the platform-infrastructure bucket
616+
- **Warp credits** - credits included with a subscription plan. Use in user-facing copy rather than "plan credits."
615617
- Use "credit" or "credits" without the "AI" prefix throughout documentation
616618

617619
### UI elements

src/content/docs/agent-platform/cloud-agents/integrations/linear.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -66,7 +66,7 @@ Because PRs are created as _you_, this makes code review, auditing, and team col
6666
### Requirements
6767

6868
* **Team membership** - The Linear integration requires you to be part of a [Warp team](/knowledge-and-collaboration/teams/). Teams can be created on any plan, including Free.
69-
* **Plan and credits** - Your team must be on a plan that supports integrations (Build, Max, or Business) and have at least 20 credits available (any type of Warp credits work). See [Access, Billing, and Identity](/agent-platform/cloud-agents/team-access-billing-and-identity/) for details.
69+
* **Plan and credits** - Your team must be on a plan that supports integrations (Build, Max, or Business) and have at least 20 credits available. See [Access, Billing, and Identity](/agent-platform/cloud-agents/team-access-billing-and-identity/) for details.
7070
* **Infrastructure** - By default, agents run on Warp-hosted infrastructure. Enterprise teams can [self-host agents](/agent-platform/cloud-agents/self-hosting/) on their own infrastructure.
7171
* **Identity** - You must be logged into Warp with the same email as your Linear workspace.
7272
* **GitHub authorization** - You must authorize the Warp GitHub app the first time you trigger an agent.

src/content/docs/agent-platform/cloud-agents/integrations/slack.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -80,7 +80,7 @@ Because PRs are created as you, the workflow slots seamlessly into your team’s
8080
### Requirements
8181

8282
* **Team membership** - The Slack integration requires you to be part of a [Warp team](/knowledge-and-collaboration/teams/). Teams can be created on any plan, including Free.
83-
* **Plan and credits** - Your team must be on a plan that supports integrations (Build, Max, or Business) and have at least 20 credits available (any type of Warp credits work). See [Access, Billing, and Identity](/agent-platform/cloud-agents/team-access-billing-and-identity/) for details.
83+
* **Plan and credits** - Your team must be on a plan that supports integrations (Build, Max, or Business) and have at least 20 credits available. See [Access, Billing, and Identity](/agent-platform/cloud-agents/team-access-billing-and-identity/) for details.
8484
* **Infrastructure** - By default, agents run on Warp-hosted infrastructure. Enterprise teams can [self-host agents](/agent-platform/cloud-agents/self-hosting/) on their own infrastructure.
8585
* **Identity** - You must be logged into Warp with the same email used in your Slack workspace.
8686
* **GitHub authorization** - You must authorize the **Warp GitHub app** the first time you trigger a Slack integration request.

src/content/docs/agent-platform/cloud-agents/overview.mdx

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -117,7 +117,7 @@ Cloud agents and [integrations](/agent-platform/cloud-agents/integrations/) run
117117

118118
Individual users can run cloud agents without being on a team. Requirements:
119119

120-
* You need at least 20 credits (any type: normal Warp credits, [Cloud Agent Credits](/support-and-community/plans-and-billing/credits/#cloud-agent-credits), or Build plan credits)
120+
* You need at least 20 credits available
121121
* Cloud agents run on Warp-hosted infrastructure
122122
* Self-hosted agents require a team subscription
123123

@@ -130,9 +130,7 @@ Integrations require you to be part of a [Warp team](/knowledge-and-collaboratio
130130
* Not supported: Pro, Turbo, Lightspeed, legacy Business
131131
* Your plan must support Add-on Credits.
132132
* **Credit requirements**
133-
* Your team must have at least 20 credits available (any type of Warp credits work) to run cloud agents and integrations.
134-
* Usage is billed based on credit type and team configuration.
135-
* Normal credits, [Cloud Agent Credits](/support-and-community/plans-and-billing/credits/#cloud-agent-credits), and [Add-on Credits](/support-and-community/plans-and-billing/add-on-credits/) all work.
133+
* Your team must have at least 20 credits available to run cloud agents and integrations.
136134

137135
For more details, see [Access, Billing, and Identity Permissions](/agent-platform/cloud-agents/team-access-billing-and-identity/).
138136

src/content/docs/agent-platform/cloud-agents/quickstart.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -157,7 +157,7 @@ Use official Docker Hub images like `node`, `python`, or `rust` for best compati
157157
Warp prompts you to authorize GitHub when you create an environment or trigger your first agent. If authorization fails or needs updating, see [How GitHub Authorization works](/reference/cli/integration-setup/#how-github-authorization-works). For automated workflows using team API keys, make sure [team GitHub authorization](/agent-platform/cloud-agents/team-access-billing-and-identity/#team-github-authorization) is configured in the Admin Panel. Also verify that repos are correctly configured in your environment with `oz environment get <ENV_ID>`.
158158

159159
**Not enough credits to run cloud agents**\
160-
Your team needs at least 20 credits available (any type of Warp credits work). Check your credit balance in Settings or see [Access, Billing, and Identity](/agent-platform/cloud-agents/team-access-billing-and-identity/) for details on credit requirements and which plans support cloud agents.
160+
Your team needs at least 20 credits available. Check your credit balance in Settings or see [Access, Billing, and Identity](/agent-platform/cloud-agents/team-access-billing-and-identity/) for details on credit requirements and which plans support cloud agents.
161161

162162
**More resources**
163163

src/content/docs/agent-platform/cloud-agents/team-access-billing-and-identity.mdx

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ Cloud agents can be used in two ways:
1818

1919
**Individual users** (without a team):
2020
* Can run cloud agents via CLI or API
21-
* Can use normal Warp credits, [Cloud Agent Credits](/support-and-community/plans-and-billing/credits/#cloud-agent-credits), or a Build plan with available credits
21+
* Can use Warp credits, including [cloud agent credits](/support-and-community/plans-and-billing/credits/#compute-credits)
2222
* Agents run on Warp-hosted infrastructure
2323
* Cannot use integrations (Slack, Linear) or self-hosted agents
2424

@@ -27,7 +27,7 @@ Cloud agents can be used in two ways:
2727
* Can use integrations (Slack, Linear) to trigger agents
2828
* Can self-host agents on their own infrastructure (Enterprise only)
2929
* Share team-level configuration (environments, secrets, integrations)
30-
* Team must be on Build, Max, or Business plan with at least 20 credits (any type) for cloud agents and integrations
30+
* Team must be on Build, Max, or Business plan with at least 20 credits for cloud agents and integrations
3131

3232
---
3333

@@ -38,7 +38,7 @@ Individual users can run cloud agents via the CLI or API without being part of a
3838
**How it works:**
3939

4040
* Run agents using `oz agent run-cloud` or the Oz API
41-
* Credits are drawn from your normal Warp credits, Cloud Agent Credits (if available), or Build plan credits
41+
* Credits are drawn from your Warp credits (including cloud agent credits, when applicable)
4242
* Agents execute on Warp-hosted infrastructure
4343

4444
**What you can do:**
@@ -79,9 +79,9 @@ Your team must meet the following requirements to run integrations:
7979
* You must be on a plan that supports **[Reload Credits (Add-on Credits)](/support-and-community/plans-and-billing/add-on-credits/)**.
8080
* Supported: **Build, Max, Business**
8181
* Not supported: Pro, Turbo, Lightspeed, legacy Business.
82-
* Your team needs at least **20 credits** available to run cloud agents and integrations (any type of Warp credits work)
82+
* Your team needs at least **20 credits** available to run cloud agents and integrations
8383

84-
When a user triggers an agent through an integration (like Slack or Linear), the run draws from credits in a specific order. It starts with any [Cloud Agent Credits](/support-and-community/plans-and-billing/credits/#cloud-agent-credits) the user has, then moves to the user's base credits, followed by the team's Reload Credits, and finally the user's own Reload Credits. Enterprises may have different payment options and credit plans that affect this flow. If all applicable credit sources are exhausted, integrations and cloud agents will not work until credits are added.
84+
When a user triggers an agent through an integration (like Slack or Linear), the run draws from credits in a specific order. It starts with any [cloud agent credits](/support-and-community/plans-and-billing/credits/#compute-credits) the user has, then moves to the user's base credits, followed by the team's Reload Credits, and finally the user's own Reload Credits. Enterprises may have different payment options and credit plans that affect this flow. If all applicable credit sources are exhausted, integrations and cloud agents will not work until credits are added.
8585

8686
:::note
8787
If you're on an Enterprise plan, please reach out to [warp.dev/contact-sales](https://warp.dev/contact-sales) with any billing questions related to integrations.

src/content/docs/enterprise/support-and-resources/billing.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -31,11 +31,11 @@ Credit allocations vary by contract. Contact your account manager for details on
3131

3232
## Cloud agent billing
3333

34-
Oz cloud agents consume credits that include a small hosting fee in addition to AI usage costs.
34+
Oz cloud agents consume AI credits for inference, compute credits for the sandbox they run in, and platform credits for the orchestration layer. See [Credits](/support-and-community/plans-and-billing/credits/) for the full breakdown of how each credit type is metered.
3535

3636
### How credits are consumed
3737

38-
On Enterprise plans, both local and cloud agent usage draw from the same team credit pool. There are no separate "cloud agent credits" or "local credits" — all agent usage consumes from your available credit sources.
38+
On Enterprise plans, local and cloud agent usage both draw from the same team credit pool across all three credit types (AI credits, compute credits, and platform credits). The credit type a run consumes depends on what infrastructure it uses, not on whether it's local or cloud.
3939

4040
For team API key runs (e.g., CI/CD pipelines, scheduled tasks), credits also draw from the team's shared pool since these runs are not tied to any individual user.
4141

src/content/docs/support-and-community/plans-and-billing/add-on-credits.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -71,7 +71,7 @@ The limit resets automatically at the start of each calendar month, so you can m
7171

7272
When your monthly credit balance renews:
7373

74-
1. Warp first consumes your included monthly plan credits (e.g., Build plan credits).
74+
1. Warp first consumes your included monthly credits (e.g., Build plan credits).
7575
2. After those are used, Warp continues to draw from any available Add-on Credits.
7676
3. If your Add-on Credits run out and Auto reload is enabled, Warp will automatically purchase more up to your monthly limit.
7777

0 commit comments

Comments
 (0)