usezombie · indykish · May 10, 2026 · May 10, 2026 · May 10, 2026 · May 10, 2026
diff --git a/.gitignore b/.gitignore
@@ -1,2 +1,3 @@
 .DS_Store
 node_modules/
+.gstack/
diff --git a/changelog.mdx b/changelog.mdx
diff --git a/concepts.mdx b/concepts.mdx
@@ -3,6 +3,8 @@ title: "Key concepts"
 description: "The four nouns, the tool bridge, and how a stage works."
 ---
 
+import { STARTER_CREDIT } from "/snippets/rates.mdx";
+
 <Tip>
   This page introduces the operator-facing model. For the canonical technical reference — system topology, data flow, billing internals, security boundary, post-ship reflection — read [`docs/architecture/`](https://github.com/usezombie/usezombie/tree/main/docs/architecture) on GitHub.
 </Tip>
@@ -13,7 +15,7 @@ usezombie has four primary objects. Everything else is infrastructure.
 
 <CardGroup cols={2}>
   <Card title="Tenant" icon="building">
-    Your top-level billing and identity boundary. Created automatically on first Clerk sign-in. Carries the **credit balance** ($5 starter grant, never expires) and your default Stripe customer.
+    Your top-level billing and identity boundary. Created automatically on first Clerk sign-in. Carries the **credit balance** ({STARTER_CREDIT} starter credit, never expires) and your default Stripe customer.
   </Card>
   <Card title="Workspace" icon="folder-tree">
     A container for zombies and credentials. One tenant can have many workspaces (team, project, environment). Credits are **not** fragmented per workspace — every workspace debits the same tenant wallet.
@@ -29,7 +31,7 @@ usezombie has four primary objects. Everything else is infrastructure.
 ### How they relate
 
 ```
-Tenant  (wallet: $5.00, BYOK: anthropic)
+Tenant  (wallet: $5.00, provider: anthropic)
 │
 ├── Workspace: "platform-ops"
 │   │
@@ -48,12 +50,12 @@ Tenant  (wallet: $5.00, BYOK: anthropic)
 
 Every stage debits the same tenant balance regardless of which workspace the zombie lives in. This is the **single-wallet, multi-workspace** model — no per-workspace credit pools, no workspace-scoped top-ups.
 
-## Credits and BYOK
+## Credits and your model provider
 
-New tenants start with **$5** seeded at signup — never expires.
+New tenants start with **{STARTER_CREDIT}** seeded at signup — never expires.
 
 - **Hosted execution is metered.** usezombie debits credits on event receipt and per-stage execution. That's what the credit pool pays for.
-- **Inference is BYOK.** You attach your own model key (Anthropic, OpenAI, Fireworks, Together, Groq, Moonshot). usezombie marks up zero. The executor resolves your credential at the tool bridge and your provider bills you directly.
+- **You bring your provider and model.** Pick the provider (Anthropic, OpenAI, Fireworks, Together, Groq, Moonshot), attach the key, and pay them directly. usezombie marks up zero on inference. The executor resolves your credential at the tool bridge.
 - **Debits happen on completed work only.** A stage that fails before producing output does not debit.
 
 See [Billing and cost control](/billing/plans).
@@ -108,6 +110,6 @@ A trigger lands on the event stream. A stage opens. The agent calls tools allow-
   </Accordion>
 
   <Accordion title="Budget">
-    Dollar ceilings on hosted execution (the platform compute that runs your zombie — separate from your model provider's bill) declared in `TRIGGER.md`. `daily_dollars` caps spend over a rolling 24-hour window; `monthly_dollars` caps the calendar month. Hitting either ceiling stops new stages from opening. Inference cost is BYOK — your provider's own caps apply there.
+    Dollar ceilings on hosted execution (the platform compute that runs your zombie — separate from your model provider's bill) declared in `TRIGGER.md`. `daily_dollars` caps spend over a rolling 24-hour window; `monthly_dollars` caps the calendar month. Hitting either ceiling stops new stages from opening. Inference is on your model provider's bill, not on your usezombie invoice — your provider's own caps apply there.
   </Accordion>
 </AccordionGroup>
diff --git a/index.mdx b/index.mdx
@@ -1,10 +1,12 @@
 ---
 title: usezombie
-description: "Durable, BYOK, markdown-defined agent runtime — for operators who own their outcomes."
+description: "Always-on agent runtime that wakes on your events, gathers evidence against your infra, and posts evidenced diagnoses to Slack. Markdown-defined."
 ---
 
+import { STARTER_CREDIT } from "/snippets/rates.mdx";
+
 <Warning>
-  🧟 **v2 — Early Access · do not run in production.** This release is for design partners and internal testing only. APIs, agent behaviour, schemas, and CLI flags will change without warning. Please don't point real workloads at `api.usezombie.com` yet — we will tell you when it's ready. Self-host arrives in v3.
+  🧟 **Stealth-mode testing.** usezombie is in private alpha — APIs and agent behavior may change without long deprecation windows. Want a hand calibrating a zombie or to join as a design partner? Email [usezombie@agentmail.to](mailto:usezombie@agentmail.to).
 </Warning>
 
 ## A long-lived runtime for one operational outcome
@@ -19,8 +21,8 @@ usezombie is a durable runtime that captures the senior engineer's playbook in m
   <Card title="Open source" icon="github">
     The runtime that holds your credentials and runs against your infrastructure is code you can read. Apache-2.0.
   </Card>
-  <Card title="BYOK (Bring Your Own Key)" icon="key">
-    Attach your own model provider's API key — Anthropic, OpenAI, Fireworks (Kimi K2), Together, Groq, Moonshot. Zero markup on inference. You pay your provider directly.
+  <Card title="You bring your provider and model" icon="key">
+    Pick the provider — Anthropic, OpenAI, Fireworks (Kimi K2), Together, Groq, Moonshot — attach the key, and pay them directly. Zero markup on inference.
   </Card>
   <Card title="Markdown-defined" icon="file-lines">
     Behaviour lives in `SKILL.md` + `TRIGGER.md`. Iterate on prose, not redeploys. No YAML allowlists, no DAG editors.
@@ -51,7 +53,7 @@ A zombie does its work in **stages** — one stage is one end-to-end execution o
     Risky actions block until a human clicks Approve in the dashboard or Slack. The wait survives worker restarts.
   </Card>
   <Card title="Spend ceiling" icon="gauge-high">
-    Per-day and per-month dollar caps. `$5` starter credit that never expires. Inference cost is yours, paid to your provider directly.
+    Per-day and per-month dollar caps. {STARTER_CREDIT} starter credit that never expires. Inference cost is yours, paid to your provider directly.
   </Card>
   <Card title="Kill switch" icon="power-off">
     `zombiectl kill` stops the stage cleanly; nothing on the activity stream is lost. Resume via `zombiectl steer`.
@@ -77,7 +79,7 @@ A zombie does its work in **stages** — one stage is one end-to-end execution o
     Every `zombiectl` command, with examples.
   </Card>
   <Card title="Architecture" icon="diagram-project" href="https://github.com/usezombie/usezombie/tree/main/docs/architecture">
-    The canonical technical reference — capabilities, data flow, billing + BYOK, path to bastion, post-ship reflection.
+    The canonical technical reference — capabilities, data flow, billing + model providers, path to bastion, post-ship reflection.
   </Card>
   <Card title="GitHub" icon="github" href="https://github.com/usezombie/usezombie">
     Source, issues, design partners welcome.

diff --git a/quickstart.mdx b/quickstart.mdx
@@ -3,6 +3,8 @@ title: Quickstart
 description: "Install zombiectl, run /usezombie-install-platform-ops, see a real diagnosis in Slack."
 ---
 
+import { STARTER_CREDIT } from "/snippets/rates.mdx";
+
 This walks through installing the flagship `platform-ops` zombie on one of your repositories. Total time: about ten minutes from a cold machine. At the end, a deploy failure on the repo lands an evidenced diagnosis in your Slack channel.
 
 <Steps>
@@ -37,7 +39,7 @@ This walks through installing the flagship `platform-ops` zombie on one of your
   zombiectl login
   ```
 
-  Opens a Clerk OAuth flow in your browser. New accounts come with a `$5` starter credit pool — never expires, covers both hosted execution and inference against the platform-managed default model.
+  Opens a Clerk OAuth flow in your browser. New accounts come with a {STARTER_CREDIT} starter credit pool — never expires, covers hosted execution (event receipts + stages). You bring your provider and model — pay them directly. usezombie marks up zero on inference.
 
   Login also fetches your tenant's workspaces and selects the first one as active locally. Signup auto-provisions a default workspace, so your CLI is ready to install zombies immediately — no `workspace add` required.
 </Step>

diff --git a/snippets/rates.mdx b/snippets/rates.mdx
@@ -0,0 +1,14 @@
+{/*
+  Single source of truth for usezombie pricing strings on the docs site.
+
+  Mirrors the canonical Zig + TS rate constants:
+    - src/state/tenant_billing.zig         (EVENT_PLATFORM_CENTS, STAGE_CENTS, STARTER_CREDIT_CENTS)
+    - ui/packages/website/src/lib/rates.ts (RATES_CENTS / RATES_DISPLAY)
+
+  When those change, update the values here in lockstep. Bumping a rate
+  requires a paired docs PR — there is no automated cross-repo guard yet.
+*/}
+
+export const STARTER_CREDIT = "$5";
+export const EVENT_RATE = "$0.01";
+export const STAGE_RATE = "$0.10";