Referral command reference

Refer a developer. Earn $10/month toward your agent bill.

Up to $120 per friend.

The ctx CLI is the entire referrer dashboard. There is no referral website or web dashboard. This is an ordinary person-to-person referral program, not a creator or publisher affiliate program. You need a verified identity to refer, but you do not need a ctx pro trial or paid ctx pro subscription.

Create a codename

ctx referral create <codename>
ctx referral create <codename> --format json

Your codename is user-chosen, public, and immutable after creation. This command may open WorkOS AuthKit so you can sign in and verify your email.

Share exactly this command:

ctx pro --referral <codename>

The referred developer must use that command to start the referred ctx pro trial. There is no referral link, cookie, install parameter, or website form. An ordinary anonymous ctx pro trial lasts 14 days; an eligible trial with an accepted referral codename lasts 30 days. The first accepted direct attribution is final and cannot be replaced or applied later.

Check status

ctx referral status
ctx referral status --format json

Status shows only your private aggregate referral, commission, adjustment, and payout state in the CLI. manual_review_cents is accrued commission awaiting a review outcome. processing_cents is cash in a sent payout batch that has not settled. paid_cents is historical cash actually settled and does not decrease after a reversal; a post-paid reversal increases the nonnegative debt_cents balance instead. It does not identify the people you referred or expose invoice-level customer activity. --format json uses only a cached sign-in and never opens a browser.

Every aggregate status satisfies:

earned_cents + debt_cents
  = pending_cents + manual_review_cents + payable_cents
    + processing_cents + paid_cents

Set up payouts

ctx referral payout
ctx referral payout --no-open
ctx referral payout --country US --format json

When payout onboarding is available, this command opens Stripe's hosted flow for your one individual payout-recipient relationship. Before ctx creates that recipient, interactive setup asks for your country. Stripe then collects identity, tax, bank, and other payout details in its hosted flow; ctx does not collect them. You do not onboard again for each invoice or referral. Within the referrer flow, WorkOS AuthKit and Stripe-hosted payout onboarding are the only browser transitions. --no-open prints the one-use Stripe URL instead. --format json never starts interactive sign-in or opens a browser; it fails safely when no cached session exists. Automation may use the advanced --country option with a two-letter uppercase country code. ctx does not infer country from identity, organization, email, IP address, billing information, or any other signal, and there is no company payout option.

Pro remains $20 USD per month; there is no annual plan. Each distinct qualifying paid monthly invoice can earn a $10 USD cash commission for invoices 1 through 12, for a maximum of $120 USD per direct referral. Invoice 1 and invoice 2 each accrue a pending $10 commission, but neither matures until invoice 2 settles, a 14-day hold passes, and ctx authoritatively reconciles both invoices. Each of invoices 3 through 12 has its own 14-day hold and authoritative reconciliation.

Refunds and disputes void unpaid commission. If a commission was already paid, the reversal becomes a negative adjustment represented by debt_cents, is deducted from future aggregate earnings, and is sent to manual review; ctx does not externally claw back the payment. Eligible commissions are paid manually in aggregate batches to your single Stripe recipient. A sent, unsettled batch is processing rather than payable or paid. Onboarding never approves or sends a payout automatically. See the Terms of Use for eligibility, disclosure, review, adjustment, and payout conditions, and the Privacy Policy for the referral records ctx keeps.