Authentication

login

Log in to Simplifyd Cloud. The CLI will prompt for your email and password, then store your session token in ~/.simplifyd/config.json.

edge auth login
edge auth login --email user@example.com

Flags

Two-factor authentication

If your account has two-factor authentication enabled, the password step alone does not create a session — the CLI prompts for a code before it stores anything:

edge auth login
Email: user@example.com
Password:
Two-factor code: 123456
✓ Logged in as user@example.com

Either a code from your authenticator app or one of your recovery codes works. A rejected code can be retried without re-entering your password.

Non-interactive login

In CI/CD environments stdin is not a TTY. Use the CLOUD_TOKEN environment variable instead of running edge auth login:

export CLOUD_TOKEN=<token>
edge workspace list

See CI/CD usage for a full guide.

Config file location

Credentials are stored at:

~/.simplifyd/config.json

The file is created automatically on first login with permissions 0600. Writes are atomic (written to a .tmp file, then renamed) to prevent corruption.

logout

Remove stored credentials from ~/.simplifyd/config.json. This also clears the active workspace, project, and environment context.

edge auth logout

whoami

Print the currently authenticated user.

edge auth whoami
edge auth whoami --json

Example output

ID                    EMAIL                NAME
usr-01j2k3...         alice@example.com    Alice Smith

JSON output

edge auth whoami --json

{
  "id": "usr-01j2k3...",
  "email": "alice@example.com",
  "first_name": "Alice",
  "last_name": "Smith",
  "created_at": "2025-01-15T09:00:00Z"
}