bcdock auth login

Log in via email OTP (returning users; account must already exist)

Synopsis¶

Authenticate using the email one-time password flow.

Use this for returning users. Login does NOT create new accounts - brand-new emails get an explicit error pointing at 'bcdock auth signup'. New users:

bcdock auth join-waitlist
(wait for invite email)
bcdock auth signup --invite-code CODE --email you@example.com
bcdock auth login --email you@example.com

You will be prompted for your email address, then a 6-digit code sent to that address. A long-lived API key (bdk_...) is minted and stored in ~/.bcdock/credentials.json - no silent expiry.

For non-interactive use (CI, smoke tests, agents): pass --email and --otp together to skip both prompts. The OTP must already be known to the caller (Development mode accepts "000000" - see local-e2e.sh notes).

For CI/CD and agent use, prefer API keys: bcdock auth set-token

Exit codes: 0 ok 1 general error (wrong email, wrong code, email not registered) 3 auth failure 4 rate-limited

bcdock auth login [flags]

Examples¶

  bcdock auth login --email you@example.com
  bcdock auth login --email you@example.com --otp 123456

Options¶

      --email string   Email address (skips prompt)
  -h, --help           help for login
      --otp string     Pre-known OTP code - skips the interactive Code: prompt. Requires --email. Intended for smoke tests and agent flows; humans should leave this unset.

Options inherited from parent commands¶

      --api-url string     API base URL (env: BCDOCK_API_URL)
      --no-color           Disable colored output
  -o, --output string      Output format: table, json, csv (default "table")
  -q, --quiet              Suppress non-essential output
      --timeout duration   Request timeout (default 30s)
      --token string       API token (env: BCDOCK_TOKEN)

bcdock auth login