Skip to Content
Referenceoo CLI

oo login

Sign up or sign in through the OpenOrange App.

oo login

Sign in and save the credential for later commands.

Without --sunport, the OpenOrange App opens in your browser: sign up or sign in there and choose a Sunport, then approve the code that Sunport shows. With --sunport, sign in to that Sunport directly; --with-token reads an existing API token from stdin instead. The credential is kept in your OS keychain, or in a mode-0600 file with --insecure-storage or where the keychain refuses (agent tools such as Claude Code and Codex). oo prints the Sunport's name and address, and whether you made it just now.

The first Sunport you sign in to becomes the current one, which commands use without --sunport; a later login leaves it as it is, and oo auth use NAME switches. To pin one for a single shell, set OPENORANGE_API_URL to its profile name or address.

oo login [options]
ArgumentRequiredDefaultChoicesDescription
--app APPnoApp HTTPS origin (default: https://app.openorange.ai)
--with-tokennoread an API token from stdin
--insecure-storagenoexplicitly use a mode-0600 file instead of the OS keychain
--no-browsernoprint the device URL without opening a browser
--name NAMEnosave a convenient Sunport profile name

It also takes the connection options.

On this page