horizechCLI
Account commandslatest · 0.1.2

horizech login

Sign in with your Horizech Account in the browser.

horizech login [--no-browser] [--json]

Also available as hws login.

Opens your browser at the Horizech sign-in page. After you sign in and approve access, the browser hands control back to the CLI and the session is saved. One sign-in covers every Horizech product. hws login does the same.

  • The CLI waits up to 5 minutes for you to finish. Press Ctrl+C to cancel (exit code 130).
  • The sign-in link is always printed too, so you can open it yourself if the browser does not start.
  • If no system keychain is available, the session is saved to a file readable only by you, and the CLI says so. See Signing in.

Options

OptionDescriptionDefault
--no-browserOnly print the sign-in link; do not try to open a browser.
--jsonPrint a machine-readable result on stdout. Progress goes to stderr.

Examples

Sign in

$ horizech login

Print the link instead of opening the browser

$ horizech login --no-browser

With --json

stdout
{
  "user": { "sub": "…", "email": "[email protected]", "name": "Your Name", "roles": [], "is_root": false },
  "store": "keychain"
}

API calls

What this command calls, for debugging and for anyone scripting the same thing. Registry paths are on https://api.horizech.com, OAuth2 paths on https://horizech.com. See Registry API.

MethodPathNotes
GET/OAuth2/Authorizeidentity provider, in your browser
POST/OAuth2/Tokenidentity provider
GET/OAuth2/UserInfoidentity provider