Skip to main content
Agent-first onboarding is for people who want to try SiteGPT before creating an account. An AI agent can start with only a website URL, create a temporary chatbot, configure it with normal CLI commands, test it, and then share one onboarding URL where the human can preview and claim the chatbot. Agents that support Auth.md-style discovery can also start from:
That file points agents to the same anonymous registration flow. Use the CLI commands on this page when the agent can run terminal commands. Use this flow when the user says something like:
If the user already has a SiteGPT account and wants changes inside that account, use Install and log in, then run normal chatbot commands.

​
How it works

1

Start from a website URL

This command is public. It does not require login.
2

Capture the returned setup details

The response includes:
3

Use the temporary token for setup

Use the returned token as SITEGPT_API_TOKEN for all setup commands:
You can also export it in the shell where the agent is working:
4

Configure and test the chatbot

Add knowledge, persona, instructions, settings, starters, followups, and icons with the normal CLI command groups.Before sharing the onboarding URL, check setup progress:
5

Share the onboarding URL

Give the human data.onboardingUrl after the chatbot is useful. The page lets them test the chatbot and claim it.

​
Setup checklist

sitegpt onboarding status --json includes data.setupChecklist. Use this as the agent’s progress signal before sharing the onboarding URL: Checklist items cover knowledge, persona, instructions, conversation starters, follow-up prompts, and brand styling.

​
Claiming the chatbot

After the human tests the chatbot, ask whether they want to claim it. If yes, ask for: Then run:
For new customers, the response returns a checkout URL. The checkout opens on SiteGPT’s pricing page. After the free trial starts, SiteGPT transfers the temporary chatbot into the claimed email’s account. If the email already has an active SiteGPT subscription, the user should open the onboarding URL while signed in and claim from the page. SiteGPT will attach the chatbot directly when the account has an available chatbot slot.

​
Temporary token behavior

The temporary token is scoped only to the onboarding chatbot. When the chatbot is claimed, SiteGPT transfers that token to the claimed user instead of revoking it. The token remains scoped only to that chatbot and keeps its original expiry, so the AI agent can continue final setup after claim. Temporary onboarding tokens expire automatically. Deleted onboarding workspaces revoke the temporary token immediately.

​
Delete an unclaimed workspace

If the setup is wrong or the user does not want the chatbot:
This deletes the unclaimed temporary chatbot and revokes the temporary token.