That's it. The CLI auto-detects your framework (Next.js, Vite, Astro, React, HTML), provisions a demo widget, writes .env, and copies a component into your project. No account needed.

Components (shadcn-style)

npx @serviceagent/cli add chat        # AI chat widget
npx @serviceagent/cli add calendar    # Calendar booking
npx @serviceagent/cli add voice       # Voice agent
npx @serviceagent/cli add webhook     # Webhook handler
npx @serviceagent/cli add all         # Everything

Each command copies a self-contained component file into your project — no runtime CLI dependency.

Full Setup

npx @serviceagent/cli init

Walks you through auth, workspace creation, and magic onboarding (auto-configures from your website URL).

Options

--name <name>      Site/business name
--url <url>        Site URL (for origin lock)
--platform <name>  Override detection: nextjs, react, vite, astro, html
--no-component     Skip component generation
--help             Show help

What Gets Created

Next.js / React / Vite / Astro

components/chat.tsx — Chat widget component
components/calendar-booking.tsx — Calendar booking component
components/voice-agent.tsx — Voice agent component
app/api/serviceagent/webhooks/route.ts — Webhook handler
.env.local — Environment variables

HTML

Embed snippet to copy-paste

Environment Variables

NEXT_PUBLIC_SERVICEAGENT_WIDGET_KEY=wid_xxxxx
NEXT_PUBLIC_SERVICEAGENT_API_URL=https://process.serviceagent.ai
NEXT_PUBLIC_SERVICEAGENT_BOOKING_KEY=your_booking_key
NEXT_PUBLIC_SERVICEAGENT_VOICE_ENDPOINT=wss://process.serviceagent.ai/v1/voice/stream
SERVICEAGENT_API_KEY=your_api_key
SERVICEAGENT_WEBHOOK_SECRET=your_secret