Skip to main content

​
Usage

archal login [options]
Opens a browser window to authenticate. Once approved, your token is saved to ~/.archal/credentials.json.

​
Options

FlagDescriptionDefault
--no-browserPrint the login URL instead of opening it automaticallyopens browser
--token <token>Use an API key or token directly (for CI or headless environments)—

​
Examples

# Interactive browser login
archal login

# Print the URL instead of opening it (useful over SSH)
archal login --no-browser

# Non-interactive login with a token (CI/CD)
archal login --token archal_xxx

​
Where credentials are stored

~/.archal/credentials.json — contains your token, user ID, plan tier, and available twins. You can also set the ARCHAL_TOKEN environment variable to skip file-based auth entirely.