Skip to main content

Usage

archal login [options]
Opens a browser window to authenticate. Local credentials are saved under ~/.archal/.

Options

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

Where credentials are stored

~/.archal/credentials.json stores your account identity, active workspace, workspace role, workspace plan snapshot, workspace clone catalog, expiry, and encrypted token fields. On macOS, Archal uses Keychain when available. You can also set the ARCHAL_TOKEN environment variable for CI or other non-interactive environments.