SkillHub

login

Authenticate with the registry via the browser device flow, or headless with an API token.

skillhub login authenticates you with the registry. By default it runs the browser device flow: it prints a code and opens your browser to confirm. For headless or CI environments, pass --token to authenticate with an existing API token instead.

The credential is stored in your OS keychain, falling back to a 0600-mode file. In CI you can also skip the login step entirely by setting the SKILLHUB_TOKEN environment variable.

Synopsis

skillhub login [--token <api-token>]

Flags

FlagDescription
--token <api-token>Log in with an existing API token instead of the browser device flow

Examples

skillhub login
skillhub login --token <api-token>   # headless / CI

JSON output

With --json, the data object contains:

  • user{ id (uuid), handle, displayName, avatarUrl (string|null) }.
  • registryUrl.
  • method (device | token).
  • credentialStore (keychain | file).
  • token (string).

On this page