auth, doctor, and env
Use these commands first on a fresh machine or when switching between production and the private beta.
auth
For staging validation with the private package:
auth login opens the browser, completes WorkOS sign-in, and stores a local CLI token.
doctor
doctor prints:
- effective API URL
- effective web URL
- active channel
healthz reachability
- local Node.js version
Use it before filing issues. It is the fastest way to verify whether a problem is local config, auth, or API reachability.
env
env shows both the config-file values and the effective values after environment-variable overrides.
Common staging workflow
Environment variables
If a command returns 401, check lim-beta auth whoami first. If it returns a user, then the next
thing to verify is the active company.