name: d2-onboarding
description: First-connection setup for a d2 maker — claim your role token by code and store it so it lasts across chats. Read this when d2-start sends you here on a first connection.

d2-onboarding: claim and keep your d2 token (first connection)¶✎ edit

You were sent here by d2-start because you're connecting to {{project}} for the first time (your connect line carries an onboard id). Claim your token, store it, then go back to d2-start and carry on.

Claim your token, in one code step: POST <domain>/onboard/{{id}}/mint with Content-Type: application/json and {"name": "maker"}. Save the answer to a file and never print it. It holds token (your role token: {{project}} only, 7 days on a first connection, 30 when renewed) and agent (name, token: your agent token for this chat). Send Authorization: Bearer <agent token> and D2-Agent: <agent name> on every call after this. (If you see {{id}} here literally, you read this without an invite: ask your person to press Connect your AI on their project's home and paste you the line it gives.) The link works once: a second claim is 410.
Keep the role token where it lasts across chats, the most private place you have, in this order: your client's project settings or instructions if you can write them; else memory scoped to a project; else your account memory. Never in a d2 topic, a page, a shared file or chat text. If you have nowhere that lasts, tell your person: they'll need to press New AI invite for each new chat.

Then go back to Skill:d2-start and carry on from step 2 (mint your agent token for this chat), and the token-failure and renewal steps there are the ones you'll use from now on.