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]| Argument | Required | Default | Choices | Description |
|---|---|---|---|---|
--app APP | no | App HTTPS origin (default: https://app.openorange.ai) | ||
--with-token | no | read an API token from stdin | ||
--insecure-storage | no | explicitly use a mode-0600 file instead of the OS keychain | ||
--no-browser | no | print the device URL without opening a browser | ||
--name NAME | no | save 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 statusIt 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]| Argument | Required | Default | Choices | Description |
|---|---|---|---|---|
NAME | no | the 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 logoutIt also takes the connection options.