Skip to main content

Documentation Index

Fetch the complete documentation index at: https://usenaive.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

CLI First

# Plan + subscription
naive billing plans
naive billing subscribe --plan starter

# Check current status
naive billing status

Plans

PlanPriceCredits/MonthFeatures
Starter$49/mo50All primitives, system email domain
Pro$149/mo200All primitives, custom domains, priority support
First-time subscribers get a 7-day free trial with 20 credits.

Credit Packs

One-time purchases — credits are added immediately after payment and never expire.
PackCreditsPricePer Credit
Small20$10$0.50
Medium50$23$0.46
Large100$44$0.44
XL250$100$0.40
Larger packs are more cost-effective. Credits never expire.

Subscribe to a Plan

naive billing subscribe --plan starter
Returns a checkout URL. Open it to complete payment, then verify:
naive billing status

Buy More Credits

naive billing topup --pack medium

Upgrade Your Plan

naive billing upgrade --plan pro
If you have an active subscription, this opens the billing portal where you can change plans with automatic proration.

Check Billing Status

naive billing status
Returns your current plan, subscription status, credits remaining, and period end date.

What Happens When You Run Out

Billing Blocked (no active subscription)

If your trial expires or subscription is cancelled, all operations are blocked. The error response includes available plans:
{
  "error": {
    "code": "billing_blocked",
    "message": "Your free trial has expired. Subscribe to continue.",
    "block_reason": "trial_expired",
    "plans": [
      { "id": "starter", "credits_per_month": 50, "price": "$49/mo" },
      { "id": "pro", "credits_per_month": 200, "price": "$149/mo" }
    ]
  }
}

Insufficient Credits (balance exhausted)

If you have an active subscription but no credits left, operations fail with available credit packs:
{
  "error": {
    "code": "insufficient_credits",
    "message": "Credit balance exhausted.",
    "packs": [
      { "id": "small", "credits": 20, "price": "$10" },
      { "id": "medium", "credits": 50, "price": "$23" },
      { "id": "large", "credits": 100, "price": "$44" },
      { "id": "xl", "credits": 250, "price": "$100" }
    ]
  }
}

Manage Subscription

Open the billing portal to update payment method, change plans, or cancel:
naive billing portal