菜单
Stripe checkout, pricing, subscription, Pro plan, webhook, and entitlement runbook for cmux billing work. Use when editing or debugging billing, pricing, Stripe Checkout, subscription recording, Pro plan status, webhooks, entitlement metadata, or pricing dev/prod tooling.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
cmux testing rules for Swift Testing, test target compilation, and package/refactor validation. Use when adding or changing tests, touching package/refactor code, or deciding whether reload.sh is enough validation.
View and edit cmux settings in ~/.config/cmux/cmux.json. Use when the user wants to change cmux preferences (appearance, sidebar, notifications, automation, browser, shortcuts), set a value by JSON path, validate the file, open it in an editor, or look up which keys cmux recognizes. Triggers on '/cmux-settings', 'change cmux setting', 'set <something> in cmux', 'cmux config', 'cmux.json', or 'rebind a cmux shortcut'.
Debug logging, Debug menu, runtime pitfalls, typing-latency-sensitive paths, SwiftUI list snapshot boundaries, OS-version repros, and local visual iteration for cmux. Use when adding debug probes, diagnosing UI/runtime issues, touching terminal rendering, tab/sidebar list views, drag/drop UTTypes, or using the Debug menu.
Build a custom cmux sidebar from a plain-language request. Use when the user asks for a custom sidebar, a sidebar that shows their workspaces/tabs/PRs/clock, a vibe-coded sidebar, or anything involving files in ~/.config/cmux/sidebars/. Covers authoring the interpreted SwiftUI-style file, enabling the beta flag, selecting it, and iterating with hot reload.
cmux package architecture, refactor layering, dependency inversion, file organization, DocC documentation, package design discipline, testability, and Swift 6 concurrency rules. Use before adding or meaningfully rewriting Swift files, Swift packages, coordinators, services, repositories, or public package APIs.
Backend TypeScript and Cloud VM development rules for cmux. Use when editing web/app/api, web/services, backend scripts, Cloud VM lifecycle, provider integrations, Postgres, Stack Auth pricing gates, migrations, or provider image build scripts.
| name | cmux-billing |
| description | Stripe checkout, pricing, subscription, Pro plan, webhook, and entitlement runbook for cmux billing work. Use when editing or debugging billing, pricing, Stripe Checkout, subscription recording, Pro plan status, webhooks, entitlement metadata, or pricing dev/prod tooling. |
Use this skill before changing billing, pricing, Stripe, Pro entitlement, checkout, webhook, or subscription code.
/api/billing/checkout creates Stripe Checkout Sessions for Pro when STRIPE_SECRET_KEY is set. It sets client_reference_id to the Stack user id, auto-creates an anonymous Stack user for signed-out buyers, and falls back to the legacy Stack purchase path when Stripe is unset or plan=team./api/billing/portal resolves the current Stack user, looks up their stripe_customers row, and creates a Stripe customer portal session returning to /pricing./api/billing/subscription cancels or resumes the current user's active Stripe Pro subscription, and /dashboard/billing renders localized in-dashboard plan state and self-serve billing actions.web/services/billing/purchase.ts is the shared idempotent recorder used by both /api/billing/complete and /api/stripe/webhook. It attaches email to the purchaser, records billing_email_claims on conflict, and never cross-grants based on an unverified email.cmuxPlan in Stack clientReadOnlyMetadata is the only entitlement VM code reads. cmuxVmPlan manual override wins.resolveProPlanStatus ORs legacy Stack products with active stripe_subscriptions DB rows./api/stripe/webhook is signature-verified, insert-first idempotent through stripe_webhook_events, safe for foreign events in the shared Stripe account, and gates cmux handling on metadata.app === "cmux". Return 2xx only after durable writes; return 500 to make Stripe retry.web/scripts/stripe/dev-stack.sh.CMUX_PORT into Info.plist; run the dev server on the tag's printed port. Do not hardcode a port.--db-port and never stop containers you did not create./app-pricing requires cmux_app=1.cmux_scheme threads the native deeplink return scheme. cmux-dev-* schemes are honored only for localhost requests.web/scripts/stripe/dev-reset.sh <email> to un-Pro a signed-in dev account before retesting checkout./api/billing/checkout.prod_UpIQRE6cj0nFjs.cmux-pro-monthly ($30/mo) and cmux-pro-yearly ($240/yr).we_1Tq1SZGhInAdn3JbWJReKNEN forwarding to cmux-staging.vercel.app; secrets are already in the cmux-staging Vercel project.pro-upgrade-ui-enabled-release (PostHog id 741838) gates all Pro UI and stays OFF in release until launch. DEBUG builds default the UI on.pro-checkout-enabled-release (PostHog id 741839) routes the public pricing CTA.cmux __internal_flags, once merged, inspects and overrides flags locally.web/scripts/stripe/provision-live.sh with an operator key, add the two Vercel envs, deploy, validate live with a 100 percent-off promotion code purchase, then cancel.bun run cloud-vm:preflight, bun run cloud-vm:migrate -- staging, staging deploy, then bun run cloud-vm:migrate -- production. See the Cloud VM ops flow. Never run migrations from builds.bun mock.module is process-global, so every module mock must carry every real export other suite files import. Missing exports may surface only in CI's test order as Export named X not found.DATABASE_URL being set.DrizzleQueryError; read error.cause for the pg code and constraint.Pages outside app/[locale] need a proxy.ts bypass, like /app-pricing and /billing, or next-intl rewrites them into the locale tree and they 404 through missing root layout tags. Those subtrees also need their own layout with html and body.