---
title: "alis login"
url: "https://docs.alisx.com/reference/cli/login/"
---
# alis login

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

## Synopsis

```bash
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](https://docs.alisx.com/reference/cli/index.md#global-flags).

## Examples

```bash title="Terminal"
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`.