Search Modaic documentation

Find a Modaic guide or API reference

modaic login

modaic login

Match the terminal code and device, then confirm once in the browser. Approve only requests you started. For another device, use modaic login --headless.

Flag / argumentWhat it does
--profileSession profile. Default: default.
--headless, --no-browserPrint a login URL to open on another device.
--storagekeyring (default) or private plaintext file storage on POSIX.
--timeoutLogin wait in seconds. Default: 600.
--token-stdinRead and store an API key from stdin instead of opening browser login.
-h, --helpShow usage and options.

Sessions refresh automatically. Run modaic login again if refresh fails. File storage is plaintext at rest and unsupported on Windows. Never share keys or session tokens.

Programmatic SDK clients and CI use MODAIC_API_KEY, which takes precedence over stored CLI credentials. Set MODAIC_PROFILE for normal commands; pass --profile explicitly to login, logout, and auth status.

Was this page helpful?