Skip to main content

gws login

The gws login command authenticates your CLI with the GetWebStack API using OAuth.

Usage​

gws login

Output:

Opening browser for authentication...
✓ Browser opened at https://auth.getwebstack.com
⏳ Waiting for authentication...

✓ Authentication successful!
✓ Credentials saved to ~/.gws/auth.json

Logged in as: user@example.com

Note: This command can be run from anywhere (does not require project context).

Authentication Methods​

Create a free GetWebStack account:

  • Google OAuth - Sign in with your Google account
  • GitHub OAuth - Authorize via GitHub
  • Email/Password - Standard email login with optional 2FA

Troubleshooting​

Browser Doesn't Open​

If the browser fails to open automatically, manually navigate to the URL shown in the terminal.

Authentication Timeout​

Authentication must be completed within 5 minutes. Run gws login again if timeout occurs.

Port Conflict​

GetWebStack uses ports 3000-3010 for OAuth callback. If these are in use:

# Kill process using port 3000
lsof -ti:3000 | xargs kill -9

# Try again
gws login