v1.20.0: Global session auth and new auth commands

v1.20.0 introduces global session storage so a single webflow auth login covers all CLI commands, plus two new commands for inspecting and clearing your session.

Global session storage

Running webflow auth login now saves your credentials in two places:

  • Global session file~/.config/webflow/auth.json on macOS/Linux or %APPDATA%\webflow\auth.json on Windows. This is shared across all projects and survives outside any specific project directory.
  • Project .env fileWEBFLOW_API_TOKEN continues to be written for compatibility with existing 1.x workflows.

The WEBFLOW_API_TOKEN environment variable still takes precedence over the session file, so CI/CD pipelines that set it explicitly continue to work without changes.

New auth commands

  • webflow auth status — Shows the currently authenticated user (name and email) and the active OAuth scopes for the stored token.
  • webflow auth logout — Removes the global session file and logs you out of the CLI.

Version flag shorthand

The version flag has been changed from -V to -v for convenience.

$webflow -v
$# @webflow/webflow-cli/1.20.0