Agent Integration

Read: https://corral.llamafarm.dev/llms.txt
Then add auth and Stripe billing to this app.
Free tier and Pro at $29/mo. Use Google login.

## Auth + Payments

This project uses Corral for auth, Stripe billing, and feature gating.
Corral spec: https://corral.llamafarm.dev/llms.txt
Full reference: llms-full.txt

When asked to add auth or payments:
1. Read CORRAL.md (if it exists) for project-specific context
2. Otherwise, run: npm create corral@latest
then corral init
3. Edit corral.yaml with the requested plans/features
4. Run: corral validate --json

## Auth + Payments (Corral)

This project uses Corral for auth + Stripe billing.
Read: https://corral.llamafarm.dev/llms.txt for the full spec.

- All auth/billing config lives in corral.yaml
- To add a feature gate: corral add feature <name> --plans <list> --gate <mode>
- To add a plan: corral add plan <name> --price <n>
- To sync Stripe: corral stripe push --json
- To validate: corral validate --json (exit 0 = deploy-ready)

# Install the Corral skill in OpenClaw
openclaw skill add corral

# Then just tell OpenClaw what you want:
# "Add Google auth and a $29/mo Pro plan with AI features gated"

Add user authentication to this app using Corral.
Email magic link + Google OAuth.
After setup, validate with corral validate --json.

Add auth and Stripe billing to this app using Corral.

Plans:
- Free: $0/mo — basic features, 500 API calls/month
- Pro: $29/mo — all features, 10k API calls/month, 14-day trial

Auth: Google OAuth + email magic link

Gate the "ai_analysis" feature to Pro plan with blur effect.

After setup run corral validate --json and show me the output.

Read CORRAL.md then add a feature gate for "advanced_export".
Available on Pro and Enterprise plans. Use "block" gate mode.
Run corral validate --json when done.

Add an "Enterprise" plan to Corral at $199/mo (annual only).
It should include all Pro features plus "sso" and "audit_log".
Sync to Stripe after. Show me the Stripe product IDs.

# Corral in MySaaSApp

Corral v0.4.1 · Next.js 14 (App Router) · PostgreSQL (Prisma)

## Auth Routes

- Auth handler:    src/app/api/auth/[...corral]/route.ts
- Billing handler: src/app/api/billing/[...corral]/route.ts
- Admin page:      src/app/admin/page.tsx
- Login page:      /api/auth/signin (auto-generated)

## Active Features

| Feature       | Plans                  | Gate     |
|---------------|------------------------|----------|
| basic_access  | free, pro              | (none)   |
| ai_dashboard  | pro                    | blur     |

## Active Plans

| Plan        | Price | Stripe Product     |
|-------------|-------|--------------------|
| free        | $0    | (none)             |
| pro         | $29   | prod_R2xK9mN2aLp   |

## Adding a new feature

corral add feature <name> --plans <list> --gate <mode>

## Adding a new plan

corral add plan <name> --price <n> --interval month
corral stripe push  # sync to Stripe

## Testing auth locally

corral seed --count 3 --json
npm run dev
# Then sign in at http://localhost:3000/api/auth/signin

## Environment variables required

CORRAL_SECRET, DATABASE_URL, STRIPE_SECRET_KEY,
STRIPE_WEBHOOK_SECRET, GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, SMTP_URL

# CORRAL.md is auto-updated after every corral add command
corral add feature advanced_export --plans pro --gate block
# ↑ CORRAL.md updated: advanced_export row added to features table

# Force regenerate from current corral.yaml state:
corral llms-txt --update

// Success
{
  "status": "ok",
  "command": "corral add feature",
  "result": { ... },     // command-specific data
  "warnings": [],
  "next_steps": ["corral stripe push", "corral validate"]
}

// Error — always includes a "fix" field telling agents what to do
{
  "status": "error",
  "command": "corral validate",
  "error": {
    "code": "ENV_MISSING",
    "message": "STRIPE_SECRET_KEY is not set",
    "fix": "Add STRIPE_SECRET_KEY=sk_test_... to .env.local"
  }
}

import subprocess, json

def corral(*args):
    result = subprocess.run(
        ["corral", *args, "--json"],
        capture_output=True, text=True
    )
    data = json.loads(result.stdout)
    if result.returncode != 0:
        raise RuntimeError(f"{data['error']['message']} — Fix: {data['error']['fix']}")
    return data

# Agent workflow:
analysis = corral("analyze")
print(f"Framework: {analysis['result']['framework']}")

result = corral("init", "--yes")
for step in result["next_steps"]:
    print(f"Next: {step}")

#!/bin/bash
# Agent: add Corral auth + billing (run this after reading llms.txt)
set -e

# 1. Understand the project
ANALYSIS=$(corral analyze --json)
echo "Framework: $(echo $ANALYSIS | jq -r '.result.framework')"

# 2. Scaffold
corral init --yes --json | jq '.files_created[]'

# 3-6. Add providers, plans, features, meters
corral add provider google --json
corral add provider email --magic-link --json
corral add plan pro --price 29 --trial 14 --json
corral add feature ai_dashboard --plans pro --gate blur --json
corral add meter api_calls --free 500 --pro 10000 --overage block --json

# 7. Stripe sync
STRIPE=$(corral stripe push --json)
echo "Pro price ID: $(echo $STRIPE | jq -r '.result.prices.pro')"

# 8. Validate — exit non-zero on any error
corral validate --strict --json

# 9. Seed test users
SEED=$(corral seed --count 1 --json)
echo "Test user: $(echo $SEED | jq -r '.result.users[0].email')"

echo "✓ Auth + payments installed. Login at localhost:3000/login"

{
  "mcpServers": {
    "corral": {
      "command": "npx",
      "args": ["@corral/mcp"],
      "env": {
        "CORRAL_CONFIG": "./corral.yaml"
      }
    }
  }
}