skillett login

Usage

skillett login [--key <api-key>]

Description

Authenticates you with the Skillett platform. Without flags, starts the device authorization flow (RFC 8628) which opens your browser for authentication. With --key, validates and saves the key directly.

After login, the CLI:

1. Saves SKILLETT_API_KEY and SKILLETT_PLATFORM to a local .env file
2. Detects your agent platform (Claude Code, Cursor, Windsurf, or Generic)
3. Installs the core Skillett skill pointer in the platform-appropriate directory

Options

Flag	Description	Default
--key <key>	Skip device flow, authenticate with an existing API key	—

Device authorization flow

When run without --key:

1. CLI requests a device code from POST /auth/device/code
2. Opens your browser to the verification URL
3. Displays a human-readable code (e.g., ABCD-1234) in terminal
4. Polls POST /auth/device/token every 5 seconds
5. On success, redirects you to the API Keys page to create/copy a key
6. Prompts you to paste the API key

API calls

Step	Endpoint
Request device code	POST /auth/device/code
Poll for authorization	POST /auth/device/token
Validate API key	GET /v1/me

Examples

# Device flow (interactive)
$ skillett login
Opening browser for authentication...
Enter this code: ABCD-1234
Waiting for authorization...
✓ Authorized as david@example.com
? Paste your API key: sk_a1b2c3d4...
✓ Logged in as david@example.com
✓ Core skill installed to .claude/skills/skillett/

# Direct key authentication
$ skillett login --key sk_a1b2c3d4e5f6...
✓ Logged in as david@example.com
✓ Core skill installed to .claude/skills/skillett/

Exit codes

• 0 — Successfully authenticated
• 1 — Invalid API key or authorization denied
• 2 — Network error or server unavailable