Skip to content

alis login

Sign in to Alis Build with the browser authorisation flow the TUI also uses.

Synopsis

alis login [code] [flags]

Description

When no code is provided, the sign-in URL is printed and the command prompts for the code. Open the URL, sign in, and paste the code back. With --json and no code, the URL is returned in an envelope instead of prompting; then run alis login <code> --json.

A coding agent must never run bare alis login: it blocks reading stdin and, headless, fails with LOGIN_CODE_REQUIRED.

Flags

Flag Type Default Meaning
--open bool false Open the sign-in URL in your default browser.

Plus the global flags.

Examples

Shell
alis login --open
alis login --json
alis login <code> --json

JSON output

Without a code:

JSON
{
  "url": "https://identity.alisx.com/authorize?redirect_uri=offline",
  "agent": "Ask the user to open url in a browser, sign in, and paste the code back to you; then run `alis login <code> --json`."
}

Notes

A fresh sign-in may carry no active account; alis setup status --json then points at alis accounts list and alis accounts select.