Account & Plans

Your Surge account is created and managed entirely from the CLI.

login

surge login

Prompts for email and password. If the email has no account yet, one is created—login and signup are the same step. On success, a token is stored in your ~/.netrc file (readable only by you), and every subsequent command uses it silently.

Mistype your password three times and the CLI offers to email you reset instructions.

logout

surge logout

Removes the token from ~/.netrc. The token is expired locally; log in again to mint a fresh one.

whoami

$ surge whoami
you@example.com - Standard

Shows the logged-in account and its plan. Handy in CI to confirm which account a token belongs to.

verify

surge verify

Sends a verification link to your account's email address. Verifying matters: unverified accounts publish under reduced rate limits.

token

$ surge token
6b1a5b7d0f8e4c…

Prints a token suitable for automation—CI pipelines, scripts, anywhere interactive login isn't possible. See CI & Automation for how to use it.

plan

surge plan

Shows the available plans with pricing and perks, and lets you switch with an interactive picker—upgrade or downgrade at any time. Card entry happens inline the first time a paid plan needs one.

Prefer the browser for anything billing-related:

surge plan --web       # upgrade via browser checkout
surge plan --manage    # manage plan, card & invoices in the browser

Both print a private link (valid 48 hours) that opens a secure billing page.

nuke

surge nuke

Permanently deletes your account. All projects must be torn down first—the command refuses while any remain. There is no undo.