Skip to main content
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

idyl login [flags]

​
Flags

FlagDescription
--email <string>Email address
--localhostUse localhost endpoints
-q, --quietSuppress the welcome banner and panel; print a one-line summary instead
--realm <string>Realm to login to (default: auto-detect from config)
--subnet <string>Default subnet for the new context

​
Inherited flags

FlagDescription
-a <string>, --account-id <string>Account ID to use (overrides context)
-c <string>, --context <string>Use specific context
--homedir <string>Override config directory (default: ~/.idyl)
-n <string>, --namespace <string>Namespace to use
-o <string>, --output <string>Output format (json|yaml)
-p <string>, --profile <string>Override profile

​
Examples

# Interactive login (prompts for email)
idyl login

# Login with specific email
idyl login --email [email protected]

# Login to a specific realm
idyl login --realm dev.idyl.network --email [email protected]

# Connect to localhost endpoints
idyl login --localhost