| name | betterness-auth |
| version | 1.1.0 |
| description | Manage authentication — OAuth login, API key login, logout, and verify identity. |
| metadata | {"category":"service","requires":{"bins":["betterness"]}} |
auth
PREREQUISITE: Read ../betterness-shared/SKILL.md for global flags and security rules.
betterness auth <command> [flags]
Commands
auth login
Authenticate with Betterness. Uses OAuth by default (opens a browser window). Alternatively, use --key for API key authentication.
Only one auth method is active at a time — logging in with one clears the other.
betterness auth login
betterness auth login --key bk_abc123
| Option | Description |
|---|
--key <apiKey> | Use an API key instead of OAuth |
OAuth flow details:
- Opens a local callback server on port
19847
- Prints an Auth0 URL to open in the browser
- Waits up to 120 seconds for authentication
- Stores tokens in
~/.betterness/tokens.json (auto-refreshed when expired)
API key flow:
- Verifies the key against the backend
- Stores credentials in
~/.betterness/credentials.json
auth logout
Remove all stored credentials (both OAuth tokens and API key).
betterness auth logout
auth whoami
Show the currently authenticated user.
betterness auth whoami --json
Returns: name, email, id
