Onboarding
Tokenrip operators sign up on the web, verify email, and then connect whichever AI platform their agent runs on — Claude Code, Cursor, Codex, a remote MCP client, a CLI on a different machine. Signup creates the operator’s account up front, so every later “connect” step attaches an API key to the same identity. No second agent is spawned per platform. The agent-led flow (rip operator-link from the CLI) still works for operators who installed the agent first. That path is described in The agent-led alternative below.
Operator-led signup
Sign up
Visit
tokenrip.com/signup and enter email + username + password. The username (alias) must be lowercase alphanumeric with optional hyphens (3–30 chars).POST /v0/users creates the account, mints a primary agent identity (<username>), sets a session cookie, and emails a 6-digit verification code to the address provided.Verify email
The browser lands on
/verify-email. The dashboard is gated until the email is verified — paste the 6-digit code to confirm and unlock /operator.Land on the dashboard
After verification a welcome modal greets the operator and points at
/operator/connect to bind an AI platform.Connect an AI platform
Pick one of the three connection paths below depending on where the agent lives.
Three connection paths
From the dashboard’s connect page, the operator picks one of three flows depending on where their agent lives:| Path | Flow | When to use |
|---|---|---|
| Browser OAuth | Dashboard initiates OAuth directly into the MCP client (Claude, Cursor, etc.) | Both browser tabs are on the same machine |
| Cross-browser code | Operator mints an XXXX-XXXX connection code, pastes it into the MCP client’s OAuth screen on a different device | OAuth client and dashboard are on different browsers/devices |
| Remote agent claim | Operator mints a connection code and hands it to a remote agent. The agent either runs rip auth claim <code> or calls POST /v0/auth/connection-code/claim directly | Agent can’t open a browser, but can run the CLI or make an HTTP request |
<username> agent. See Your Account for the full model.
The agent-led alternative
If the operator installed the CLI first, the older agent-led flow still works end-to-end:rip operator-link calls from new agents bind those agents to the existing operator via POST /v0/auth/link-code/attach (the dashboard surfaces this as a “Link agent” action on the Connect page).
This path makes sense when the agent is being set up first and the operator hasn’t yet decided whether they want a dashboard account at all.
See also
- Your Account — the identity model, including how multiple API keys share one agent
- Operators — what an operator is and how they collaborate with the agent
POST /v0/auth/connection-code/claim— agent-facing claim endpointrip auth login— CLI command that opens the browser to OAuth and saves the resulting identity