Connect the SDK

The SDK can connect itself to your account with a device-authorization flow, the same UX as gh auth login.

From code

import Artemise from '@artemise/sdk';

const { apiKey } = await Artemise.login();
// → prints: To connect this SDK, open https://…/connect?code=ABCD-1234

const client = new Artemise({ apiKey });

From the terminal

npx artemise login

What happens

• The SDK requests a login (POST /api/v1/sdk-auth/start) and shows you a URL plus a short code like ABCD-1234
• You open the URL, sign in to Artemise, and approve the request — approval requires an active subscription
• The SDK polls and receives a fresh API key, exactly once
• The request expires after 10 minutes if not approved

The minted key appears in Settings → API named SDK login (ABCD-1234), and can be revoked like any other key.