> ## Documentation Index
> Fetch the complete documentation index at: https://docs.idyl.network/llms.txt
> Use this file to discover all available pages before exploring further.

# idyl login

> Authenticate with IDYL

Authenticate with an IDYL realm using email verification.

This command is for users who already have an account. If you don't have
an account yet, use 'idyl signup' instead.

This command:

1. Sends a verification code to your email
2. Verifies the code to establish your identity
3. Helps you select or create a context to use
4. Saves your session for future commands

## Usage

```bash theme={null}
idyl login [flags]
```

## Flags

| Flag                | Description                                                                 |
| ------------------- | --------------------------------------------------------------------------- |
| `--email <string>`  | Email address.                                                              |
| `-q, --quiet`       | Suppress the welcome banner and panel and print a one-line summary instead. |
| `--realm <string>`  | Realm to log in to. Defaults to idyl.network.                               |
| `--subnet <string>` | Default subnet for the new context.                                         |

## Inherited flags

| Flag                                 | Description                                                        |
| ------------------------------------ | ------------------------------------------------------------------ |
| `-a <string>, --account-id <string>` | Account ID to use, overriding the current context.                 |
| `-c <string>, --context <string>`    | Use the named context for this command.                            |
| `--homedir <string>`                 | Override the configuration directory. Defaults to \~/.config/idyl. |
| `-n <string>, --namespace <string>`  | Namespace to use for this command.                                 |
| `-o <string>, --output <string>`     | Output format (json\|yaml).                                        |
| `-p <string>, --profile <string>`    | Override the access profile for this command.                      |

## Examples

```bash theme={null}
# Interactive login (prompts for email)
idyl login

# Log in with a specific email
idyl login --email developer@example.com

# Log in to a specific realm
idyl login --realm <realm> --email developer@example.com
```