CLI Quickstart

Get your affiliate program running in under 5 minutes -- program creation, Stripe webhooks, and live tracking all from your terminal.

Info

Prefer a UI? Use the dashboard quickstart instead.

Why CLI?

	Dashboard	CLI
Setup time	~15 minutes	~5 minutes
Stripe webhooks	Manual (11 steps)	Automatic (1 command)
AI agent compatible	No	Yes (`--json` mode)
Config files generated	No	Yes (`.affitor/`)

AGENTS.md follows the open standard supported by Claude Code, Cursor, GitHub Copilot, Windsurf, Aider, and 16+ AI tools. Your AI assistant reads it and integrates Affitor tracking into your codebase automatically.

Step 2 -- Add Click Tracking

Paste the script tag from the CLI output into your site's <head>:

<script src="https://api.affitor.com/js/affitor-tracker.js"
  data-affitor-program-id="YOUR_PROGRAM_ID">
</script>

Replace YOUR_PROGRAM_ID with the program ID from step 1.

The script auto-detects ?aff=PARTNER_CODE in URLs and stores a first-party cookie for attribution (90-day window by default, set in your program).

Step 3 -- Track Signups

Call signup() when a user registers:

window.affitor.signup("user_123", "user@example.com");

Step 4 -- Track Payments

Choose your payment tracking method: Server-side tracking vs Stripe integration.

Option A: Stripe integration (automatic)

Auto-configure Stripe webhooks for payment tracking:

npx affitor setup stripe

This opens Stripe Connect OAuth in your browser, then automatically creates webhook endpoints for:

checkout.session.completed -- sale tracking
invoice.payment_succeeded -- recurring commission
charge.refunded -- automatic commission clawback
customer.created -- lead tracking
customer.subscription.deleted -- churn tracking

Option B: Server-side tracking — your backend calls POST /api/v1/track/sale (any payment provider)

curl -X POST https://api.affitor.com/api/v1/track/sale \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"customer_key": "user_123", "amount_cents": 4900, "currency": "USD"}'

Step 5 -- Test Your Integration

Send test events to verify your integration:

npx affitor test click
npx affitor test lead
npx affitor test sale

Then check your program health:

npx affitor status

Non-Interactive Mode

For CI/CD and AI agents, pass --no-interactive --json to skip prompts and get machine-readable output:

npx affitor init \
  --name "My SaaS" \
  --domain example.com \
  --commission-type recurring_percent \
  --commission-rate 30 \
  --duration-months 12 \
  --cookie-duration 90 \
  --no-interactive \
  --json

Output is valid JSON, ready for AI agents to parse:

{
  "program_id": 430,
  "api_key": "affitor_...",
  "domain": "example.com",
  "status": "created",
  "tracking": {
    "script_tag": "<script src=\"...\"></script>",
    "signup_call": "window.affitor.signup(\"customer_id\", \"email\")",
    "sale_api": "POST https://api.affitor.com/api/v1/track/sale",
    "lead_api": "POST https://api.affitor.com/api/v1/track/lead"
  }
}

Running npx affitor init in a directory that already has .affitor/config.json -- delete it first or use a different directory.
Skipping the tracking script -- the CLI creates the program but does not modify your code.
Using an expired API key -- re-run npx affitor init to get a new one.