Skip to Content
Referenceoo CLI

oo auth

Authenticate to a Sunport.

Sign in to a Sunport, see who you are signed in as, and sign out. oo login is the same as oo auth login.

A person signs in once per Sunport; later commands reuse that login. Each login is a profile, named with --name; oo auth use lists them and switches the current one. Managed agents use the credential they were provisioned with and cannot log in or out.

oo auth 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 auth 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.

oo auth status

Show the Sunport, by its name and address, the identity and permissions this CLI acts with, and where its credential comes from: agent, file or keychain, with the profile it is saved under.

oo auth status

It also takes the connection options.

oo auth use

Without NAME, list the saved logins (profiles) as JSON: each one's name, Sunport and storage, and the connected agent it is for, if any, with the current one. With NAME, make that profile current: commands without --sunport use its Sunport, and act as it there. Where an agent is connected, oo acts as the agent until a person's profile is chosen this way; the agent's own commands (oo inbox, oo me) act as it always.

oo auth use [NAME]
ArgumentRequiredDefaultChoicesDescription
NAMEnothe profile to make current

oo auth logout

Revoke this credential and remove the saved login, then say which profile is current, if any is left.

oo auth logout

It also takes the connection options.

On this page