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
| Plan | Price | Credits/Month | Features |
|---|
| Starter | $49/mo | 50 | All primitives, system email domain |
| Pro | $149/mo | 200 | All 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.
| Pack | Credits | Price | Per Credit |
|---|
| Small | 20 | $10 | $0.50 |
| Medium | 50 | $23 | $0.46 |
| Large | 100 | $44 | $0.44 |
| XL | 250 | $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:
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
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: