Overview
Thelogin command will authenticate your CLI with Wormkey using OAuth device flow. This feature is planned for a future release.
Usage
Current Behavior
In v0, running this command displays:Planned Functionality
In future versions, thelogin command will:
- Initiate device flow - Display a code and URL
- Open browser - Direct you to authenticate in your browser
- Store credentials - Save authentication tokens locally
- Enable account features - Access to dashboard, analytics, and tunnel management
Expected Flow
Workaround for v0
While
login is not implemented, you can still use Wormkey by:- Running the local control plane for development
- Using the
--localflag withwormkey http - Setting
WORMKEY_ENV=localenvironment variable
Local Development Setup
Authentication in v0
Currently, Wormkey v0 operates without user accounts:- Anonymous tunnels - No authentication required to create tunnels
- Owner claim URLs - Claim tunnel ownership via one-time URLs
- No dashboard - Tunnel management through CLI only
Future Enhancements
Whenlogin is implemented, you’ll gain access to:
Persistent Sessions
Tunnels associated with your account
Web Dashboard
View and manage all your tunnels
Analytics
Traffic stats and usage metrics
Team Features
Share and collaborate on tunnels
Related Commands
wormkey http- Create tunnels (works without login)wormkey status- Check tunnel status (not yet implemented)wormkey close- Close active tunnels (not yet implemented)
See Also
- Quick Start - Get started without authentication
- Self-Hosting Setup - Run control plane locally