cmux-billing — Claude Code skill: what it does, how to install
Runbook for cmux billing architecture covering Stripe Checkout, subscription tiers, webhooks, and entitlement overrides during backend development.
npx skills add manaflow-ai/cmux --skill cmux-billing -a claude-codeWhat cmux-billing does
This skill provides context for editing billing workflows inside cmux. It maps out Stripe Checkout session generation via /api/billing/checkout, customer portal sessions, and idempotent recording in web/services/billing/purchase.ts. Inbound events at /api/stripe/webhook verify signatures, discard payloads where metadata.app is not set to cmux, and return a 500 status on failure to ensure Stripe retries.
Entitlement checks inspect Stack metadata where cmuxVmPlan overrides the mirrored cmuxPlan. Admin endpoints at /api/admin/* require verified company domains or explicit admin records. Running email grant operations before executing the admin_plan_grants database migration causes endpoints to return 503 errors.
What it helps with
- trace Stripe Checkout session creation and customer portal flows
- test checkout locally with
dev-stack.shand theCMUXDEV100coupon - debug idempotent Stripe webhook processing and event filtering
- grant or reset dev entitlements using
dev-grant.shanddev-reset.sh
Example prompts for the agent
- Explain how resolveProPlanStatus evaluates cmuxVmPlan against cmuxPlan
- How do I simulate a free checkout in development using the CMUXDEV100 coupon?
- Trace the webhook handling flow in web/services/billing/purchase.ts
How to install cmux-billing
1Skills CLI (Vercel)
npx skills add manaflow-ai/cmux --skill cmux-billing -a claude-code2Manually: put the files in place
~/.claude/skills/cmux-billing/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/cmux-billing/
1Skills CLI (Vercel)
npx skills add manaflow-ai/cmux --skill cmux-billing -a codex2Manually: put the files in place
.agents/skills/cmux-billing/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add manaflow-ai/cmux --skill cmux-billing -a cursor2Manually: put the files in place
.cursor/skills/cmux-billing/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install manaflow-ai/cmux cmux-billing2Manually: put the files in place
.github/skills/cmux-billing/SKILL.md1Skills CLI (Vercel)
npx skills add manaflow-ai/cmux --skill cmux-billing -a gemini-cli2Platform CLI
gemini skills install https://github.com/manaflow-ai/cmux --path skills/cmux-billingManually: put the files in place
.devin/skills/cmux-billing/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add manaflow-ai/cmux --skill cmux-billing -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set13
The whole set →Similar
Questions about cmux-billing
How to install cmux-billing in Claude Code?
Install it by running npx skills add manaflow-ai/cmux --skill cmux-billing -a claude-code. The file will be placed in ~/.claude/skills/cmux-billing/SKILL.md.
What is cmux-billing used for?
It acts as a technical runbook for coding against cmux billing endpoints, Stripe subscriptions, plan catalogs, and admin grant tools.
How do you test payments locally without real charges?
You can apply cmuxVmPlan: "pro" directly using web/scripts/stripe/dev-grant.sh <email> or apply the CMUXDEV100 100%-off coupon during test-mode checkout.