// Command reference
simforge login
Generated from the CLI's own help (CLI 0.2.0-rc.5). Global flags and exit codes are on the reference index.
simforge login
Sign in to a SimForge host (browser approval, or --device for a URL and code)
simforge login [OPTIONS]
| Argument / flag | Notes | What |
|---|---|---|
| --host HOST | SimForge host to sign in to. Default: SIMFORGE_HOST, then the host of the last login, then simforge.ai. Later commands use the host signed in to | |
| --device | Sign in with a code instead of a local browser: print a URL and a short code to approve from any browser (SSH, headless machines) | |
| --scope SCOPE | repeatable | A scope to request on top of the defaults (repeatable), such as keys:admin to manage API keys. The defaults cover map/runtime downloads and scenario/cloud jobs |
| --credential-store STORE | one of auto, keyring, file | Where to keep the tokens. Default: SIMFORGE_CREDENTIAL_STORE, then auto (the OS keychain, else a 0600 file; the output says which and why) |
| --device-name NAME | The name the approval page and the CLI sessions list show for this machine. Default: the host name | |
| --timeout SECONDS | default 600 | Seconds to wait for the approval |